Your own domains

On Scale (10 domains) and Fleet (50), you can use a domain you own for your own addresses. Nobody else can take addresses on it.

Setup

1. Add it. POST /domains/custom with { "domain": "example.com" }. The response includes a TXT record to publish.

2. Prove you own it. Publish the record at your registrar’s DNS:

   Type	Name	Value
   TXT	_mailcycle-verify.example.com	mailcycle-verify=<token>

   Then POST /domains/custom/example.com/check. Until this passes, the domain is a claim and reserves nothing.

3. Point the nameservers. Once ownership is proved, the response lists two Cloudflare nameservers. Set them at your registrar and check again.

4. Routing. When the nameservers are live, mail routing is set up for you, and the domain starts issuing addresses once DNS shows its MX records.

GET /domains/custom lists your domains with the step each one is on: verify_ownership, awaiting_setup, change_nameservers, setting_up, live or attention.

Removing a domain

DELETE /domains/custom/:domain removes it. It is refused with domain_in_use while addresses exist on it; delete those first.

If the plan changes

Moving to a plan without custom domains stops new addresses on them straight away, and they keep receiving for 21 days before mail is refused. They work again with nothing to redo once the plan includes them. After a missed payment, their addresses are paused and their mail held instead, and the domains are removed if the payment is still missing after 21 days.