# Send label

Sends the label to our servers for analysis to improve our recommendation system.

Endpoint: POST /label
Security: risk_access_token

## Request fields (application/json):

  - `label_type` (string, required)
    Type of label to send, which contains additional information that helps to classify the subject as fraudulent or legitimate. The API accepts both the enum values below and the legacy values (KNOWN_MALICIOUS, SUSPECTED_MALICIOUS, KNOWN_LEGIT, UNKNOWN) for backward compatibility.
    Enum: "CONFIRMED_FRAUD", "SUSPECTED_FRAUD", "CONFIRMED_LEGIT", "UNDETERMINED", "DEVICE_TAKEOVER"

  - `subject` (object, required)
    Subject of the label

  - `subject.type` (string, required)
    The subject type.
    Enum: "ACTION_ID", "CORRELATION_ID", "CAMPAIGN_ID", "USER_ID", "IP_ADDRESS", "VERIFICATION_SESSION_ID", "FRAUD_RING_ID"

  - `subject.value` (string, required)
    The subject value
    Example: "a05f8ae1-718f-4c33-a20c-682df281af7c"

  - `subject.recommendations` (array,null)
    For FRAUD_RING_ID labels only. Allows labeling actions with specific recommendation.
    Enum: "allow", "trust", "challenge", "deny"

  - `subject.is_campaign_confirmed` (boolean,null)
    For CAMPAIGN_ID labels only. Defines whether or not to label actions related to the campaign.

  - `use_case` (string)
    The fraud scenario.
    Enum: "ACCOUNT_TAKEOVER", "FIRST_PARTY_FRAUD", "IDENTITY_THEFT", "MONEY_MULE", "BOT_ATTACK", "SYNTHETIC_IDENTITY", "SOCIAL_ENGINEERING"

  - `source` (string)
    Source of the label information, such as a customer complaint about friction or additional information from another risk or fraud system.
    Enum: "MANUAL_REVIEW", "CUSTOMER_COMPLAINTS", "CHARGEBACKS", "OTHER_VENDORS"

## Response 201 fields (application/json):

  - `message` (string, required)

  - `label_id` (string, required)
    ID of the saved label

  - `label` (object, required)

  - `label.label_id` (string)
    ID of the saved label

  - `label.label_type` (string, required)
    Type of label to send, which contains additional information that helps to classify the subject as fraudulent or legitimate. The API accepts both the enum values below and the legacy values (KNOWN_MALICIOUS, SUSPECTED_MALICIOUS, KNOWN_LEGIT, UNKNOWN) for backward compatibility.
    Enum: "CONFIRMED_FRAUD", "SUSPECTED_FRAUD", "CONFIRMED_LEGIT", "UNDETERMINED", "DEVICE_TAKEOVER"

  - `label.subject` (object, required)
    Subject of the label

  - `label.subject.type` (string, required)
    The subject type.
    Enum: "ACTION_ID", "CORRELATION_ID", "CAMPAIGN_ID", "USER_ID", "IP_ADDRESS", "VERIFICATION_SESSION_ID", "FRAUD_RING_ID"

  - `label.subject.value` (string, required)
    The subject value
    Example: "a05f8ae1-718f-4c33-a20c-682df281af7c"

  - `label.subject.recommendations` (array,null)
    For FRAUD_RING_ID labels only. Allows labeling actions with specific recommendation.
    Enum: "allow", "trust", "challenge", "deny"

  - `label.subject.is_campaign_confirmed` (boolean,null)
    For CAMPAIGN_ID labels only. Defines whether or not to label actions related to the campaign.

  - `label.use_case` (string)
    The fraud scenario.
    Enum: "ACCOUNT_TAKEOVER", "FIRST_PARTY_FRAUD", "IDENTITY_THEFT", "MONEY_MULE", "BOT_ATTACK", "SYNTHETIC_IDENTITY", "SOCIAL_ENGINEERING"

  - `label.source` (string)
    Source of the label information, such as a customer complaint about friction or additional information from another risk or fraud system.
    Enum: "MANUAL_REVIEW", "CUSTOMER_COMPLAINTS", "CHARGEBACKS", "OTHER_VENDORS"

  - `label.label_timestamp` (number)
    Unix time indicating the label creation time
    Example: 1725961384920

  - `afftectedActionIds` (array, required)
    Example: ["af819f2b3e2f1b2820077cb09fe92de5769c4e4b24030cf683f4d0b155ac4999","9b83568185c39e4acb3e5d09176f0a70efdf5c414c2d1d90cb803dfb0b93ec53"]


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 429 fields

## Response 500 fields