Email Verification

Send an email-ownership verification code

Changed on

Email a 6-digit code to the DIR's authorizer email to confirm ownership of that address. The code goes to the authorizer, not to the caller. If the authorizer is someone else (for example a client's executive), that person has to share the code with whoever is completing setup.

How long the code lasts: 15 minutes by default. 8 hours when the DIR has a call center (BPO) linked through bpo_authorizations whose authorization is pending review or approved (a rejected authorization does not count). Link the call center before you send the code: a code sent before the link keeps the 15-minute window, and a code sent after the link lasts 8 hours. The email states the window, and expires_at in the response always shows the exact expiry.

To resend, call this endpoint again. Each send issues a fresh code and invalidates the previous one. Sends are limited to one every 60 seconds and 10 per DIR per UTC day. A throttled send returns 429 with retry_after_secs and sends_remaining_today in the error meta.

Submit the code to POST /dir/{dir_id}/verify_email/confirm.

post/dir/{dir_id}/verify_email

Request

  • Base URL: https://api.telnyx.com/v2
  • URL: https://api.telnyx.com/v2/dir/{dir_id}/verify_email
  • Auth: HTTP bearer

Path parameters

dir_idstring uuid required
Example:16635d38-75a6-4481-82e8-69af60e05011

The DIR id. Lowercase UUID.

Response

A code was emailed; the current verification state is returned.

Example response

{
  "data": {
    "record_type": "email_verification",
    "status": "sent",
    "expires_at": "2026-07-30T17:15:00Z",
    "sends_remaining_today": 9
  }
}

Changes

  • 5e782364444aRevision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status