<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Lists the app's email domains and where each one is in setup.

An app with no email set up returns an empty list rather than an error, so this is the safe endpoint to poll while a domain verifies.

You normally get one domain. During a replacement you get two, the old one still sending and the new one still verifying. Disabled and suspended domains aren't listed, so unlinking a custom domain drops its email domain from this list until you link the domain again.

Every entry repeats the same id, which identifies the app's email configuration rather than the individual domain. Tell entries apart by domain, and pass that value to the endpoints that take a domain parameter.

{
  "email_domains": [
    {
      "configuration_status": "active",
      "dns_records": [],
      "domain": "example.com",
      "enabled_at": "2026-08-20T16:31:00",
      "external": true,
      "from_email": "no-reply@example.com",
      "id": "68b1c0d4e7b91d003c45a1f2",
      "sender_name": "Nordwind Furniture"
    }
  ]
}