Request and send a verification code

POST /api/verification-codes
O auth2

Request a verification code for the provided identifier (email/phone). if you're using email as the identifier, you need to setup your email connector first. if you're using phone as the identifier, you need to setup your SMS connector first.

application/json

Body object Required

One of:
object-1 object object-2 object
  • email string(regex) Required

    Format should match the following pattern: /^\S+@\S+\.\S+$/.

Responses

  • 204

    Verification code requested and sent successfully.

  • 400

    Bad request. The payload may be invalid.

  • 401

    Unauthorized

  • 403

    Forbidden

  • 501

    Not Implemented

POST /api/verification-codes 
curl \
 --request POST 'https://[tenant_id].logto.app/api/verification-codes' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"email":"string"}'
Request examples 
{
  "email": "string"
}
{
  "phone": "string"
}