Email Verification

Confirm an enterprise email-ownership verification code

Changed on

Submit the 6-digit code that was emailed to the enterprise account's contact email. On success the contact email is marked verified.

For security, any failure (wrong, expired, already-used, or too many attempts) returns the same generic message.

post/enterprises/{enterprise_id}/verify_email/confirm

Request

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

Path parameters

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

The enterprise id. Lowercase UUID.

Request body

codestring required

The 6-digit code sent to the enterprise account's contact email.

Example request

{
  "code": "482915"
}

Response

The contact email is verified.

Example response

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

Changes