Sign in
Email Domain DNS Records

Verify DNS records for an email domain

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

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

Changed in 5 of the 99 revisions of this API.272

  • 16bfa298dc714See the full diff
    • ●

      added the new 40901 enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new 40901 enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new 40901 enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new 40901 enum value to the // response property for the response status

      response-property-enum-value-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • b1bf96d8391e3See the full diff
    • ●

      added the new not_required enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new not_required enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new shared_inbound enum value to the / response property for the response status

      response-property-enum-value-added

  • 80833e66e01011See the full diff
    • ▲

      the / response's property type changed from string to object for status

      response-property-type-changed

    • ○

      added to the / response property allOf list for the response status

      response-property-all-of-added

  • 6ef0ae248bf71See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 224ed0d8a5c31See the full diff
    • ▲

      api path removed without deprecation

      api-path-removed-without-deprecation

    This revision also has 111 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 99 revisions, 1 has no diff computed.