POST /api/experience/verification/verification-code

Create a new CodeVerification record and sends the code to the specified identifier. The code verification can be used to verify the given identifier.

application/json

Body Required

  • identifier object Required

    The identifier (email address or phone number) to send the verification code to.

    One of:
    object-1 object object-2 object
  • interactionEvent string Required

    The interaction event for which the verification code will be used. Supported values are SignIn, Register, and ForgotPassword. This determines the template for the verification code.

    Values are SignIn, Register, or ForgotPassword.

Responses

  • 200 application/json

    The verification code has been successfully sent.

    Hide response attribute Show response attribute object
    • verificationId string Required

      The unique ID of the verification record. Required to verify the code.
  • 400

    An invalid identifier was provided.

  • 404

    Not Found

  • 422

    Unprocessable Content

  • 501

    The connector for sending the verification code is not configured.

POST /api/experience/verification/verification-code 
curl \
 --request POST 'https://[tenant_id].logto.app/api/experience/verification/verification-code' \
 --header "Content-Type: application/json" \
 --data '{"identifier":{"type":"string","value":"string"},"interactionEvent":"SignIn"}'
Request examples 
{
  "identifier": {
    "type": "string",
    "value": "string"
  },
  "interactionEvent": "SignIn"
}
Response examples (200) 
{
  "verificationId": "string"
}