# Telnyx Messaging: Email — Documentation Index
> Email documentation within the Messaging section of the Telnyx developer docs (https://developers.telnyx.com).
> This file: https://developers.telnyx.com/docs/development/llms/messaging-email-llms-txt.md · Root index: https://developers.telnyx.com/llms.txt

## Getting Started

- [Overview](https://developers.telnyx.com/docs/messaging/email/overview.md): Telnyx Email API — a full email platform with sending, receiving, inboxes, templates, tracking, suppression management, and deliverability tools.
- [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, request size limits, and destination provider throttling 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

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

### 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
- [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
- [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 (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.
- [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
- [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): Registers a domain for email sending and optional inbound delivery. The response includes the domain configuration and current verification state.
- [Delete an email domain](https://developers.telnyx.com/api-reference/email-domains/delete-an-email-domain.md): Deletes an email domain configuration. Verified domains require `force=true`, and shared domains are read-only for non-owner accounts.
- [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): Updates mutable settings for an existing email domain, including inbound delivery and tracking configuration. Shared domains are read-only for non-owner accoun…
- [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): Returns the DNS records Telnyx generated for domain ownership and DKIM verification, plus MX records when inbound delivery is enabled.
- [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): Checks the published DNS records against the records required for the email domain and returns the latest verification results.

### Email Webhooks

- [List webhooks for an email domain](https://developers.telnyx.com/api-reference/email-webhooks/list-webhooks-for-an-email-domain.md): Returns a paginated list of webhook subscriptions scoped to the email domain. Results can be sorted by creation time.
- [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…
- [Delete a webhook](https://developers.telnyx.com/api-reference/email-webhooks/delete-a-webhook.md): Deletes the webhook subscription identified by ID within the specified email domain and returns the deleted subscription.
- [Retrieve a webhook](https://developers.telnyx.com/api-reference/email-webhooks/retrieve-a-webhook.md): Returns the webhook subscription identified by ID within the specified email domain.
- [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.

### 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.
- [Delete an email template](https://developers.telnyx.com/api-reference/email-templates/delete-an-email-template.md): Deletes the account-owned template. The operation returns `204` with no body and prevents future sends or renders from using the deleted template ID.
- [Get an email template](https://developers.telnyx.com/api-reference/email-templates/get-an-email-template.md): Returns the account-owned template identified by ID, including its Liquid subject and bodies, declared variables, and timestamps.
- [Update an email template](https://developers.telnyx.com/api-reference/email-templates/update-an-email-template.md): Updates one or more template fields.
- [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.
- [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
- [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`
- [Retrieve a suppression](https://developers.telnyx.com/api-reference/email-suppressions/retrieve-a-suppression.md): Returns the account-owned suppression identified by ID. Cross-account lookups and malformed IDs return `404` without exposing another account’s data.
- [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): Creates an account-owned unsubscribe group for associating email categories with separate recipient suppression lists.
- [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
- [Retrieve an unsubscribe group](https://developers.telnyx.com/api-reference/email-unsubscribe-groups/retrieve-an-unsubscribe-group.md): Returns the account-owned unsubscribe group identified by ID.
- [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.
- [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.