> ## Documentation Index
> Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Email llms.txt

> Machine-readable documentation index for Email (Messaging) — guide pages and API endpoints for AI agents and LLMs

# Telnyx Messaging: Email — Documentation Index

> Email documentation within the Messaging section of the Telnyx developer docs ([https://developers.telnyx.com](https://developers.telnyx.com)).
> Root index: [https://developers.telnyx.com/llms.txt](https://developers.telnyx.com/llms.txt) · Messaging index: [https://developers.telnyx.com/development/llms/messaging-llms-txt.md](https://developers.telnyx.com/development/llms/messaging-llms-txt.md) · Full content for this subsection: [https://developers.telnyx.com/development/llms/messaging-email-llms-full-txt.md](https://developers.telnyx.com/development/llms/messaging-email-llms-full-txt.md)

## Getting Started

* [Send Your First Email](https://developers.telnyx.com/docs/messaging/email/quickstart.md): Send your first email with the Telnyx Email API — add a sending domain, verify DNS, and POST to the /email\_messages endpoint.

## Sending Email

* [Email API Guide](https://developers.telnyx.com/docs/messaging/email/send-email.md): Complete guide to sending email with the Telnyx Email API — full payload options, HTML and attachments, scheduling, idempotency, tracking, batch sending, and error handling.
* [Migrate to Telnyx](https://developers.telnyx.com/docs/messaging/email/migrate-to-telnyx.md): Migrate your email sending from any ESP to Telnyx Email — authentication, sending, templates, webhooks, suppressions, and domain setup.
* [Rate Limits](https://developers.telnyx.com/docs/messaging/email/rate-limits.md): Rate limits, sending quotas, and request size limits for the Telnyx Email API — batch sending, scheduled sending, and how to request increases.
* [Error Codes](https://developers.telnyx.com/docs/messaging/email/error-codes.md): Reference for all Telnyx Email API error codes, HTTP status codes, and troubleshooting guidance.

## Inboxes

* [Manage Inboxes](https://developers.telnyx.com/docs/messaging/email/inboxes.md): Create and manage email inboxes, read and reply to messages, organize threads with labels, filter senders, and send drafts with the Telnyx Email Inboxes API.

## Domains & Validation

* [Email Domains & DKIM](https://developers.telnyx.com/docs/messaging/email/domains.md): Register, verify, and manage sending domains with the Telnyx Email API — DNS records (SPF, DKIM, DMARC, MX, ownership), domain health, DKIM signing, status lifecycle, and reputation.
* [Email Validation](https://developers.telnyx.com/docs/messaging/email/validation.md): Validate email addresses before you send — syntax, MX/deliverability signal, disposable domains, role addresses, and typo suggestions, single and batch.

## Deliverability

* [Deliverability & Warm-up](https://developers.telnyx.com/docs/messaging/email/deliverability.md): Build and protect your email sender reputation with Telnyx — domain warm-up, authentication, list hygiene, bounce handling, and complaint monitoring.
* [Deliverability Best Practices](https://developers.telnyx.com/docs/messaging/email/deliverability-best-practices.md): Understand email deliverability — how receiving providers evaluate your mail, why messages land in spam, and how to interpret Telnyx delivery error codes when things go wrong.

## Templates & Suppression

* [Templates](https://developers.telnyx.com/docs/messaging/email/templates.md): Create, manage, and render email templates with the Telnyx Email API — Liquid variables, server-side render/preview without sending, and sending with a template.
* [Suppressions & Unsubscribes](https://developers.telnyx.com/docs/messaging/email/suppressions.md): Manage the Telnyx Email suppression list — reason taxonomy, account vs group scope, CSV import from SendGrid/Mailgun/SES, send-time override behavior, unsubscribe groups, and RFC 8058 one-click unsub…
* [Unsubscribe Groups](https://developers.telnyx.com/docs/messaging/email/unsubscribe-groups.md): Group-based unsubscribe management for the Telnyx Email API — let recipients opt out of specific email categories without unsubscribing from everything.

## Events & Webhooks

* [Webhooks & Events](https://developers.telnyx.com/docs/messaging/email/webhooks-events.md): Track every email event with Telnyx — subscribe via webhooks or poll the Events API. Complete event-type reference, webhook CRUD, Ed25519 signature verification, and polling patterns.
* [Event Lifecycle](https://developers.telnyx.com/docs/messaging/email/event-lifecycle.md): Understand the full lifecycle of an email message — from send to delivery to bounce — and how each stage maps to Telnyx webhook events, the Events API, and the Email Detail Record (EDR).

## API Reference (Email)

### Email Messages

* [List email messages](https://developers.telnyx.com/api-reference/email-messages/list-email-messages.md): Lists messages sorted newest first by `created_at desc, id desc`. No filters other than
* [Create or send an email message](https://developers.telnyx.com/api-reference/email-messages/create-or-send-an-email-message.md): Queues, schedules, or sandbox-sends an email message. The legacy `/v2/emails` POST route
* [Delete email messages by address](https://developers.telnyx.com/api-reference/email-messages/delete-email-messages-by-address.md): Permanently deletes every email in the authenticated account sent from or to the
* [Create a batch of email messages](https://developers.telnyx.com/api-reference/email-messages/create-a-batch-of-email-messages.md): Creates up to 50 email messages in a single request.
* [List events for an email message](https://developers.telnyx.com/api-reference/email-messages/list-events-for-an-email-message.md): Lists events for a single message sorted oldest first by `occurred_at asc, id asc`.
* [Cancel a scheduled email message](https://developers.telnyx.com/api-reference/email-messages/cancel-a-scheduled-email-message.md): Cancels a scheduled email and returns it with status `cancelled`. The legacy `/v2/emails/{id}/schedule` DELETE route is an alias.
* [Get an email message](https://developers.telnyx.com/api-reference/email-messages/get-an-email-message.md): The legacy `/v2/emails/{id}` GET route is a backward-compatible alias for this operation.
* [Delete an email message](https://developers.telnyx.com/api-reference/email-messages/delete-an-email-message.md): Permanently deletes an account-scoped email message, its events, its durable
* [List recipients for an email message](https://developers.telnyx.com/api-reference/email-messages/list-recipients-for-an-email-message.md): Lists per-recipient delivery states for a single message with cursor pagination.
* [Get a single recipient's delivery state](https://developers.telnyx.com/api-reference/email-messages/get-a-single-recipients-delivery-state.md): Returns the current delivery state of a single recipient, including status,

### Email Inboxes

* [List email inboxes](https://developers.telnyx.com/api-reference/email-inboxes/list-email-inboxes.md): Lists the account's non-deleted inboxes newest first using stable cursor pagination.
* [Create an email inbox](https://developers.telnyx.com/api-reference/email-inboxes/create-an-email-inbox.md): Creates an inbox on an inbound-enabled domain. When `domain_id` is omitted, Telnyx
* [Get an email inbox](https://developers.telnyx.com/api-reference/email-inboxes/get-an-email-inbox.md): Returns an account-scoped, non-deleted inbox. Missing and foreign inboxes are indistinguishable.
* [Delete an email inbox](https://developers.telnyx.com/api-reference/email-inboxes/delete-an-email-inbox.md): Soft-deletes an account-scoped inbox. Its address remains reserved and the inbox is no longer returned by list or get operations.
* [List sender filters for an inbox](https://developers.telnyx.com/api-reference/email-inboxes/list-sender-filters-for-an-inbox.md): Returns the inbox's sender allowlist and blocklist. Entries are normalized
* [Add sender filter entries to an inbox](https://developers.telnyx.com/api-reference/email-inboxes/add-sender-filter-entries-to-an-inbox.md): Adds entries to either the allowlist or blocklist. The operation is an
* [Replace sender filters for an inbox](https://developers.telnyx.com/api-reference/email-inboxes/replace-sender-filters-for-an-inbox.md): Replaces both sender filter lists atomically. Omitting either list clears
* [Remove sender filter entries from an inbox](https://developers.telnyx.com/api-reference/email-inboxes/remove-sender-filter-entries-from-an-inbox.md): Removes entries from either the allowlist or blocklist. The operation is
* [List and search messages in an inbox](https://developers.telnyx.com/api-reference/email-inboxes/list-and-search-messages-in-an-inbox.md): Lists inbound messages newest first. All access is scoped to the authenticated
* [Update an inbox message](https://developers.telnyx.com/api-reference/email-inboxes/update-an-inbox-message.md): Updates the explicit read state of an account-scoped inbound message. Set `read_at`
* [Forward an inbox message](https://developers.telnyx.com/api-reference/email-inboxes/forward-an-inbox-message.md): Sends from the inbox address through the standard email send pipeline to caller-supplied
* [Reply to an inbox message](https://developers.telnyx.com/api-reference/email-inboxes/reply-to-an-inbox-message.md): Sends from the inbox address through the standard email send pipeline. The recipient is
* [Reply all to an inbox message](https://developers.telnyx.com/api-reference/email-inboxes/reply-all-to-an-inbox-message.md): Sends from the inbox address through the standard email send pipeline. The To list starts
* [Add labels to an inbox message](https://developers.telnyx.com/api-reference/email-inboxes/add-labels-to-an-inbox-message.md): Adds one or more mutable labels to a message. Labels carry agent
* [Remove labels from an inbox message](https://developers.telnyx.com/api-reference/email-inboxes/remove-labels-from-an-inbox-message.md): Removes one or more labels from a message. Idempotent — removing a
* [List threads in an inbox](https://developers.telnyx.com/api-reference/email-inboxes/list-threads-in-an-inbox.md): Lists thread summaries newest first using stable cursor pagination.
* [Get a thread and a page of its messages](https://developers.telnyx.com/api-reference/email-inboxes/get-a-thread-and-a-page-of-its-messages.md): Returns a bounded page of inbound and outbound thread messages interleaved in chronological order using stable cursor pagination.
* [Add labels to an inbox thread](https://developers.telnyx.com/api-reference/email-inboxes/add-labels-to-an-inbox-thread.md): Adds one or more mutable labels to a thread, letting an agent mark a
* [Remove labels from an inbox thread](https://developers.telnyx.com/api-reference/email-inboxes/remove-labels-from-an-inbox-thread.md): Removes one or more labels from a thread. Idempotent — removing a label

### Email Drafts

* [List drafts in an inbox](https://developers.telnyx.com/api-reference/email-drafts/list-drafts-in-an-inbox.md): Lists drafts newest first using stable cursor pagination. All access is scoped
* [Create a draft](https://developers.telnyx.com/api-reference/email-drafts/create-a-draft.md): Creates an unsent draft in the inbox. Every field is optional — a draft is a
* [Retrieve a draft](https://developers.telnyx.com/api-reference/email-drafts/retrieve-a-draft.md): Returns a single draft. Drafts that have been sent remain retrievable, so the
* [Update a draft](https://developers.telnyx.com/api-reference/email-drafts/update-a-draft.md): Updates the supplied fields on a draft. `account_id` and `inbox_id` are
* [Update a draft (alias)](https://developers.telnyx.com/api-reference/email-drafts/update-a-draft-alias.md): Identical to `PUT`; both apply a partial update to the supplied fields.
* [Delete a draft](https://developers.telnyx.com/api-reference/email-drafts/delete-a-draft.md): Permanently deletes an unsent draft. Drafts that are being sent or have been sent
* [Send a draft](https://developers.telnyx.com/api-reference/email-drafts/send-a-draft.md): Sends the draft through the standard send pipeline — the same domain resolution,
* [Create a reply draft](https://developers.telnyx.com/api-reference/email-drafts/create-a-reply-draft.md): Creates an unsent reply draft for an inbound message. Unlike the

### Email Threads

* [List threads across every inbox in the account](https://developers.telnyx.com/api-reference/email-threads/list-threads-across-every-inbox-in-the-account.md): Lists thread summaries for the whole account, newest first, using stable
* [Get an account-wide thread and a page of its messages](https://developers.telnyx.com/api-reference/email-threads/get-an-account-wide-thread-and-a-page-of-its-messages.md): Returns a thread and a bounded page of its inbound and outbound messages,

### Email Domains

* [List email domains](https://developers.telnyx.com/api-reference/email-domains/list-email-domains.md): Shared (`type: shared`) Telnyx-managed domains are included/readable for every account, in addition to the account's own custom domains.
* [Create an email domain](https://developers.telnyx.com/api-reference/email-domains/create-an-email-domain.md)
* [Retrieve an email domain](https://developers.telnyx.com/api-reference/email-domains/retrieve-an-email-domain.md): Shared (`type: shared`) Telnyx-managed domains are included/readable for every account, in addition to the account's own custom domains.
* [Update an email domain](https://developers.telnyx.com/api-reference/email-domains/update-an-email-domain.md)
* [Delete an email domain](https://developers.telnyx.com/api-reference/email-domains/delete-an-email-domain.md)
* [Get domain health summary](https://developers.telnyx.com/api-reference/email-domains/get-domain-health-summary.md): Returns a summary of domain health including verification status and usability.

### Email Domain DNS Records

* [List DNS records for an email domain](https://developers.telnyx.com/api-reference/email-domain-dns-records/list-dns-records-for-an-email-domain.md)
* [Verify DNS records for an email domain](https://developers.telnyx.com/api-reference/email-domain-dns-records/verify-dns-records-for-an-email-domain.md)

### Email Webhooks

* [List webhooks for an email domain](https://developers.telnyx.com/api-reference/email-webhooks/list-webhooks-for-an-email-domain.md)
* [Create a webhook for an email domain](https://developers.telnyx.com/api-reference/email-webhooks/create-a-webhook-for-an-email-domain.md): Creates a webhook endpoint subscribed to a specific allowlist of event types. Both `email.*` events (published by email-api) and `email_domain.*` events (publi…
* [Retrieve a webhook](https://developers.telnyx.com/api-reference/email-webhooks/retrieve-a-webhook.md)
* [Update a webhook](https://developers.telnyx.com/api-reference/email-webhooks/update-a-webhook.md): Update a webhook's URL and/or event subscription. A webhook is bound to its domain — `domain_id` is not mutable.
* [Delete a webhook](https://developers.telnyx.com/api-reference/email-webhooks/delete-a-webhook.md)

### Email Validations

* [Validate a single email address](https://developers.telnyx.com/api-reference/email-validations/validate-a-single-email-address.md): Validates a single email address and returns deliverability checks.
* [Create a batch email validation job](https://developers.telnyx.com/api-reference/email-validations/create-a-batch-email-validation-job.md): Creates an asynchronous batch validation job for up to 1,000 email addresses.
* [Get a batch email validation job](https://developers.telnyx.com/api-reference/email-validations/get-a-batch-email-validation-job.md): Retrieves the current status and, once completed, validation results for a batch job.

### Email Templates

* [List email templates](https://developers.telnyx.com/api-reference/email-templates/list-email-templates.md): Lists templates sorted newest first by `created_at desc, id desc`.
* [Create an email template](https://developers.telnyx.com/api-reference/email-templates/create-an-email-template.md): Creates a Liquid email template. Variables are auto-extracted when omitted.
* [Get an email template](https://developers.telnyx.com/api-reference/email-templates/get-an-email-template.md)
* [Replace an email template](https://developers.telnyx.com/api-reference/email-templates/replace-an-email-template.md): Replaces template fields. Behaves identically to PATCH; provided for compatibility with Phoenix resource routes.
* [Update an email template](https://developers.telnyx.com/api-reference/email-templates/update-an-email-template.md): Updates one or more template fields.
* [Delete an email template](https://developers.telnyx.com/api-reference/email-templates/delete-an-email-template.md)
* [Render an email template](https://developers.telnyx.com/api-reference/email-templates/render-an-email-template.md): Renders a template using the provided Liquid variables. Missing `template_variables` defaults to `{}`.

### Email Suppressions

* [List suppressions](https://developers.telnyx.com/api-reference/email-suppressions/list-suppressions.md): Account-scoped list. Two mutually exclusive pagination modes:
* [Create a manual suppression](https://developers.telnyx.com/api-reference/email-suppressions/create-a-manual-suppression.md): Creates a suppression with `reason: manual_block` and `source: manual`.
* [Export suppressions as CSV](https://developers.telnyx.com/api-reference/email-suppressions/export-suppressions-as-csv.md): Streams the account's suppressions as a chunked CSV (server-side
* [Retrieve a suppression](https://developers.telnyx.com/api-reference/email-suppressions/retrieve-a-suppression.md)
* [Soft-delete a suppression](https://developers.telnyx.com/api-reference/email-suppressions/soft-delete-a-suppression.md): Soft-deletes (status → `removed`; tombstone retained). A `removed`
* [List audit events for a suppression](https://developers.telnyx.com/api-reference/email-suppressions/list-audit-events-for-a-suppression.md): Offset pagination only (`page[number]` default 1, `page[size]`

### Email Suppression Imports

* [Create an async CSV import job](https://developers.telnyx.com/api-reference/email-suppression-imports/create-an-async-csv-import-job.md): Accepts `multipart/form-data` with a `file` field (the CSV) and an
* [Poll an import job](https://developers.telnyx.com/api-reference/email-suppression-imports/poll-an-import-job.md): Account-scoped fetch (cross-account → 404; malformed UUID → 404).

### Email Unsubscribe Groups

* [List unsubscribe groups](https://developers.telnyx.com/api-reference/email-unsubscribe-groups/list-unsubscribe-groups.md): Offset pagination only (`page[number]` default 1, `page[size]`
* [Create an unsubscribe group](https://developers.telnyx.com/api-reference/email-unsubscribe-groups/create-an-unsubscribe-group.md)
* [Retrieve an unsubscribe group](https://developers.telnyx.com/api-reference/email-unsubscribe-groups/retrieve-an-unsubscribe-group.md)
* [Update an unsubscribe group](https://developers.telnyx.com/api-reference/email-unsubscribe-groups/update-an-unsubscribe-group.md): Partial update (only `name` / `description`). `PUT` is not routed.
* [Delete an unsubscribe group](https://developers.telnyx.com/api-reference/email-unsubscribe-groups/delete-an-unsubscribe-group.md): If the group has 0 active suppressions, hard-deletes the row. With
* [List suppressions in a group](https://developers.telnyx.com/api-reference/email-unsubscribe-groups/list-suppressions-in-a-group.md): Account + group scoped. Offset pagination only (`page[number]`
* [Add a group suppression](https://developers.telnyx.com/api-reference/email-unsubscribe-groups/add-a-group-suppression.md): Creates a suppression with `reason: unsubscribe`, `source: manual`,
* [Remove a group suppression](https://developers.telnyx.com/api-reference/email-unsubscribe-groups/remove-a-group-suppression.md): Soft-deletes all active blocks for (account, group, normalized

### Email Events

* [List account email events](https://developers.telnyx.com/api-reference/email-events/list-account-email-events.md): Lists account-level email events sorted oldest first by `occurred_at asc, id asc`.
* [Get email event statistics](https://developers.telnyx.com/api-reference/email-events/get-email-event-statistics.md): Returns counts and rates for email events over a time range. The default start time is 30 days ago.