---
title: "Send an email-ownership verification code to an enterprise"
method: POST
path: "/enterprises/{enterprise_id}/verify_email"
tags: ["Email Verification"]
---

# Send an email-ownership verification code to an enterprise

`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

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`.

## Path parameters

- `enterprise_id` string, uuid, required

## Response `200`

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

- EnterpriseEmailVerificationStatusWrapped
  - `data` EnterpriseEmailVerificationStatus, required: Verification state for an enterprise account's contact email.
    - `record_type` 'email_verification', required: Always `email_verification`.
    - `email_verified` boolean, required: Whether the enterprise account's contact email has been confirmed.
    - `status` 'sent' | 'verified', required: `sent` after a code is emailed; `verified` after a successful confirm.
    - `expires_at` string, date-time, nullable: When the code just sent stops being accepted. Present on a send response; null on a confirm response.
    - `sends_remaining_today` integer, nullable: How many more codes may be requested for this enterprise account today. Present on a send response; null on a confirm response.

## Other responses

- `400`: An error occurred. The response carries the standard Telnyx error envelope.
- `404`: An error occurred. The response carries the standard Telnyx error envelope.
- `429`: An error occurred. The response carries the standard Telnyx error envelope.
- `503`: An error occurred. The response carries the standard Telnyx error envelope.

## Changes

> 152 revisions in range; 1 not diffed.

- **2026-10-01** `27a8076ac294`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/enterprises/:enterprise_id/verify_email/post.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/f82938f53ff4?raw)