Email Domain DNS Records

Verify DNS records for an email domain

Changed on

Checks the published DNS records against the records required for the email domain and returns the latest verification results.

post/email_domains/{domain_id}/verify

Request

  • Base URL
    https://api.telnyx.com/v2
  • URL
    https://api.telnyx.com/v2/email_domains/{domain_id}/verify
  • Auth
    HTTP bearer

Path parameters

domain_idstring uuid required

Email domain UUID

Response

Updated email domain with latest DNS verification results

Example response

{
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "record_type": "email_domain",
    "domain": "example.com",
    "type": "custom",
    "status": "pending",
    "usable_for_sending": false,
    "usable_for_inbound": false,
    "verification": {
      "ownership": "pending",
      "spf": "missing_optional",
      "dkim": "pending",
      "dmarc": "missing_optional",
      "mx": "not_required"
    },
    "dns_records": [],
    "dkim": {
      "selector": null,
      "algorithm": null,
      "key_length": null,
      "active": false,
      "rotated_at": null
    },
    "inbound": {
      "enabled": false,
      "catch_all": false,
      "mx_required": false
    },
    "dmarc_policy": {
      "p": "none",
      "pct": 100,
      "rua": "mailto:dmarc@telnyx.com"
    },
    "tracking": {
      "open_tracking": false,
      "click_tracking": false,
      "unsubscribe_tracking": false
    },
    "created_at": "2026-01-01T00:00:00Z",
    "updated_at": "2026-01-01T00:00:00Z",
    "verified_at": null
  }
}

Changes