Skip to main content
Docs

You are viewing an archived version of the docs.Go to latest version

Verification

These are all methods on the SignUp class that allow you to verify a user's sign-up request.

prepareVerification()

function prepareVerification(params: PrepareVerificationParams): Promise<SignUp>;

The prepareVerification is used to initiate the verification process for a field that requires it. As mentioned above, there are two fields that need to be verified:

  • emailAddress: The email address can be verified via an email code. This is a one-time code that is sent to the email already provided to the SignUp object. The prepareVerification sends this email.
  • phoneNumber: The phone number can be verified via a phone code. This is a one-time code that is sent via an SMS to the phone already provided to the SignUp object. The prepareVerification sends this SMS.

PrepareVerificationParams

  • Name
    strategy
    Type
    'phone_code' | 'email_code' | 'email_link' | 'saml' | 'oauth_<provider>' | 'web3_metamask_signature'
    Description

    The verification strategy to validate the user's sign-up request.
    The following strategies are supported:

    • phone_code: Send an SMS with a unique token to input.
    • email_code: Send an email with a unique token to input.
    • email_link: Send an email with a link which validates sign-up
    • saml: The user will be authenticated with SAML. Experimental
    • oauth_<provider>: The user will be authenticated with their social sign-in account. See available OAuth providers.
    • web3_metamask_signature: The verification will attempt to be completed using the user's web3 wallet public address. The web3_wallet_id parameter can also be specified to select which of the user's known web3 wallets will be used. Currently Clerk supports Metamask.

  • Name
    redirectUrl
    Type
    string
    Description

    The URL to redirect the user to after the verification process is complete.
    Only supported on email_link, oauth_<provider>, and saml strategies.

attemptVerification()

function attemptVerification(params: AttemptVerificationParams): Promise<SignUp>;

Attempts to complete the in-flight verification process that corresponds to the given strategy. In order to use this method, you should first initiate a verification process by calling SignUp.prepareVerification.

Depending on the strategy, the method parameters could differ.

AttemptVerificationParams

  • Name
    strategy
    Type
    'phone_code' | 'email_code' | 'web3_metamask_signature'
    Description

    The verification strategy to complete the user's sign-up request against.
    The following strategies are supported:

    • phone_code: Validates an SMS with a unique token to input.
    • email_code: Validates an email with a unique token to input.
    • web3_metamask_signature: The verification will attempt to be completed using the user's web3 wallet public address. The web3_wallet_id parameter can also be specified to select which of the user's known web3 wallets will be used. Currently Clerk supports Metamask.

  • Name
    code
    Type
    string
    Description

    The code that was sent to the user via the phone_code or email_code verification strategies.

  • Name
    signature
    Type
    string
    Description

    The signature that was sent to the user via the Web3 verification strategy.

Feedback

What did you think of this content?
Edit this page on GitHub

Last updated on