---
descriptions:
  create_attempt:
    ip_address: The IP address of the client
    user_agent: The user agent of the client
    email: The email address of the user making the attempt
    auth_method: |
      The authentication method used for the attempt

      Possible values:
      - `Password`
      - `Passkey`
      - `Authenticator`
      - `SMS_OTP`
      - `Email_OTP`
      - `Social`
      - `SSO`
      - `Other`
    action: The action of the attempt. `sign-up` or `sign-in`
  create_response:
    verdict: |
      The verdict of the response 

      Possible values:
      - `allow`
      - `block` 
      - `challenge`
    reason: >-
      The reason for the verdict, e.g. `detected_enabled_radar_control` or
      `no_radar_control_detected`
    attempt_id: The ID of the Radar attempt
    control: |
      The Radar control, only present if the verdict is `block` or `challenge`

      Possible values:
      - `bot_detection`
      - `brute_force_attack`
      - `credential_stuffing`
      - `domain_sign_up_rate_limit`
      - `ip_sign_up_rate_limit`
      - `impossible_travel`
      - `repeat_sign_up`
      - `stale_account`
      - `unrecognized_device`
      - `restriction`
    blocklist_type: |
      The type of the blocklist if the verdict was `block` 

      Possible values:
      - `ip_address`
      - `domain`
      - `email`
      - `device`
      - `user_agent`
      - `device_fingerprint`
reference:
  curl:
    - url: /reference/radar/attempts/create
      key: create_attempt
      id: create_attempt
      title: /radar/attempts
      type: POST
      properties:
        - key: ip_address
          type: string
          description: (create_attempt.ip_address)
        - key: user_agent
          type: string
          description: (create_attempt.user_agent)
        - key: email
          type: string
          description: (create_attempt.email)
        - key: auth_method
          type: >-
            "Password" | "Passkey" | "Authenticator" | "SMS_OTP" | "Email_OTP" |
            "Social" | "SSO" | "Other"
          description: (create_attempt.auth_method)
        - key: action
          type: '"sign-up" | "sign-in"'
          description: (create_attempt.action)
      returns:
        - key: verdict
          type: '"allow" | "block" | "challenge"'
          description: (create_response.verdict)
        - key: reason
          type: string
          description: (create_response.reason)
        - key: attempt_id
          type: string
          description: (create_response.attempt_id)
        - key: control
          type: >-
            "bot_detection" | "brute_force_attack" | "credential_stuffing" |
            "domain_sign_up_rate_limit" | "ip_sign_up_rate_limit" |
            "impossible_travel" | "repeat_sign_up" | "stale_account" |
            "unrecognized_device" | "restriction"
          optional: true
          description: (create_response.control)
        - key: blocklist_type
          type: >-
            "ip_address" | "domain" | "email" | "device" | "user_agent" |
            "device_fingerprint"
          optional: true
          description: (create_response.blocklist_type)
originalPath: .tmp-workos-clone/packages/docs/content/reference/radar/attempts/create.mdx
---

## Create an Attempt

Evaluates an authentication attempt based on the parameters provided and returns a verdict.

<CodeBlock referenceId="create_attempt">
  <CodeBlockTab title="Request" file="create-attempt-request" />
  <CodeBlockTab title="Response" file="create-attempt-response" />
</CodeBlock>