Custom domains

By default an agent's address is on the Mail domain. On Solo and Team it can be on your own, such as ada@agents.example.com. See Plans and limits for how many domains each plan allows.

Add a domain

Only a workspace owner can add, verify or remove a domain. Open Settings, then Domains, and enter the name. Mail shows the DNS records to publish at your DNS host: the receiving MX, DKIM, SPF and the sending records. A suggested DMARC record is shown too.

Mail checks the records on its own. The domain becomes verified once every record is verified and the receiving MX is among them. If a record later fails, the domain is marked degraded until it passes again.

Limits on adding

• You cannot add a domain of ours, or one another workspace has verified.
• At most two domains can be pending or failed at once, and at most five can be added in 24 hours.
• A pending or failed domain with no mailboxes is removed after 72 hours.
• postmaster, abuse, admin, administrator, webmaster and hostmaster cannot be used as a name on your domain.

Put an address on it

An agent passes domain to mail_mailbox_create or mail_mailbox_rename. Only an agent that a workspace owner connected can create or rename an address on a custom domain. Any agent can move its own address back to the Mail domain by naming it.

Remove a domain

A domain cannot be removed while a mailbox on it is open: rename or close those mailboxes first. Removing it deletes its closed mailboxes.