---
title: "Update an email domain"
method: PATCH
path: "/email_domains/{id}"
tags: ["Email Domains"]
---

# Update an email domain

`PATCH /email_domains/{id}`

## Path parameters

- `id` string, uuid, required

## Request body

- UpdateEmailDomainRequest
  - `inbound_enabled` boolean — Enable or disable inbound routing for this domain
  - `dmarc_policy` EmailDMARCPolicy — DMARC policy for a sending domain. Drives the recommended _dmarc.<domain> TXT record. DMARC is advisory and never blocks sending. When omitted or null, the domain uses the advisory default (v=DMARC1; p=none; rua=mailto:dmarc@telnyx.com).
    - `p` 'none' | 'quarantine' | 'reject' — Policy applied to messages that fail alignment.
    - `pct` integer — Percentage of messages the policy applies to. Omitted from the record when 100.
    - `rua` string, nullable — URI for aggregate reports. Defaults to the Telnyx address when absent; null omits it.
    - `sp` 'none' | 'quarantine' | 'reject', nullable — Policy for subdomains. Omitted from the record when null.
  - `tracking` DomainsTrackingSettings
    - `open_tracking` boolean — Inject a tracking pixel into HTML messages to record open events.
    - `click_tracking` boolean — Rewrite HTML links through a tracking redirect to record click events.
    - `unsubscribe_tracking` boolean — Add RFC 8058 List-Unsubscribe headers with a signed one-click unsubscribe URL. Enabled by default; Gmail/Yahoo bulk-sender rules require one-click unsubscribe support.

## Response `200`

Email domain updated

- EmailDomainResponse
  - `data` EmailDomain, required
    - `id` string, uuid, required
    - `record_type` 'email_domain', required
    - `domain` string, required
    - `type` 'custom' | 'shared' | 'shared_inbound', required
    - `status` 'pending' | 'verifying' | 'verified' | 'failed' | 'degraded' | 'suspended', required
    - `usable_for_sending` boolean, required
    - `usable_for_inbound` boolean, required
    - `verification` EmailDomainVerification, required
      - `ownership` 'pending' | 'verified' | 'not_required', required
      - `spf` 'missing_optional' | 'verified' | 'failed' | 'not_required', required
      - `dkim` 'pending' | 'verified' | 'failed', required
      - `dmarc` 'missing_optional' | 'verified' | 'failed', required
      - `mx` 'not_required' | 'pending' | 'verified' | 'failed', required
    - `dns_records` DNSRecord[], required
      - `id` string, uuid, required
      - `purpose` 'ownership' | 'spf' | 'dkim' | 'dmarc' | 'mx', required
      - `record_type` 'TXT' | 'MX', required
      - `host` string, required
      - `value` string, required
      - `actual_value` string, nullable
      - `priority` integer, nullable
      - `required` boolean, required
      - `status` 'pending' | 'verified' | 'failed' | 'not_required', required
    - `dkim` DKIMStatus, required
      - `selector` string, nullable, required
      - `algorithm` 'rsa-sha256' | 'null', nullable, required
      - `key_length` 2048 | null, nullable, required
      - `active` boolean, required
      - `rotated_at` string, date-time, nullable, required
    - `inbound` InboundConfig, required
      - `enabled` boolean, required
      - `catch_all` boolean, required
      - `mx_required` boolean, required
    - `dmarc_policy` EmailDMARCPolicy, required — DMARC policy for a sending domain. Drives the recommended _dmarc.<domain> TXT record. DMARC is advisory and never blocks sending. When omitted or null, the domain uses the advisory default (v=DMARC1; p=none; rua=mailto:dmarc@telnyx.com).
      - `p` 'none' | 'quarantine' | 'reject' — Policy applied to messages that fail alignment.
      - `pct` integer — Percentage of messages the policy applies to. Omitted from the record when 100.
      - `rua` string, nullable — URI for aggregate reports. Defaults to the Telnyx address when absent; null omits it.
      - `sp` 'none' | 'quarantine' | 'reject', nullable — Policy for subdomains. Omitted from the record when null.
    - `tracking` DomainsTrackingSettings, required
      - `open_tracking` boolean — Inject a tracking pixel into HTML messages to record open events.
      - `click_tracking` boolean — Rewrite HTML links through a tracking redirect to record click events.
      - `unsubscribe_tracking` boolean — Add RFC 8058 List-Unsubscribe headers with a signed one-click unsubscribe URL. Enabled by default; Gmail/Yahoo bulk-sender rules require one-click unsubscribe support.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `verified_at` string, date-time, nullable
    - `reputation` object — Sender reputation for this domain (present on all domain responses).
      - `band` string — Reputation band, e.g. good/warn/poor.
      - `breakdown` object
      - `computed_at` string, date-time, nullable

## Other responses

- `403` — Forbidden — shared domains are read-only for non-owner accounts (error code 10008).
- `404` — Resource not found
- `422` — Validation failed
- `500` — Internal server error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)