Email Verification

Send an email-ownership verification code to an enterprise

Changed on

Email a 6-digit code to the enterprise account's contact email to confirm ownership of that address.

A BPO (Business Process Outsourcer) account has no DIR, so it proves ownership of its own contact email here rather than through a DIR. A BPO account cannot be approved for use until this contact email is verified.

The code expires in 15 minutes. Requesting a new code invalidates any previous one. Resends are rate limited (a short cooldown plus a daily cap). Submit the code to POST /enterprises/{enterprise_id}/verify_email/confirm.

post/enterprises/{enterprise_id}/verify_email

Request

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

Path parameters

enterprise_idstring uuid required
Example:4a6192a4-573d-446d-b3ce-aff9117272a6

The enterprise 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