Email Domains

The email_domain object

A domain registered with the email bridge for sending and receiving mail.

After registration the domain starts in pending; publish the returned DKIM records, then poll the verify action until it flips to verified.

idstring

Email domain ID.

objectstringenumValues:email_domain

Resource type identifier.

domainstring

The fully-qualified domain name (e.g. support.acme.com).

statusstring

Verification status.

pending: registered and awaiting DKIM confirmation.
verified: DKIM confirmed; the domain can send and receive mail.
failed: verification could not be completed.

dkim_tokensarray of string

The DKIM CNAME tokens the customer must publish in DNS to verify the domain.

verified_atstring (date-time)nullable

When the domain's DKIM verification was confirmed.

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last updated timestamp.

Used by

POSTCreate Email DomainEmail Domains GETList Email DomainsEmail Domains GETGet Email DomainEmail Domains POSTVerify Email DomainEmail Domains POSTCreate Email InboxEmail Inboxes PATCHUpdate Email InboxEmail Inboxes GETList Email InboxesEmail Inboxes GETGet Email InboxEmail Inboxes

email_domain example

{
  "id": "emdom_018e88072d1320808dc9aaa01",
  "object": "email_domain",
  "domain": "support.acme.com",
  "status": "pending",
  "dkim_tokens": [
    "abc123._domainkey.support.acme.com",
    "def456._domainkey.support.acme.com"
  ],
  "verified_at": null,
  "created_at": "2026-05-10T00:00:00Z",
  "updated_at": "2026-05-10T00:23:00Z"
}

{
  "id": "emdom_018e88072d1320808dc9aaa01",
  "object": "email_domain",
  "domain": "support.acme.com",
  "status": "pending",
  "dkim_tokens": [
    "abc123._domainkey.support.acme.com",
    "def456._domainkey.support.acme.com"
  ],
  "verified_at": null,
  "created_at": "2026-05-10T00:00:00Z",
  "updated_at": "2026-05-10T00:23:00Z"
}

Email Domains

Attributes

Used by