Skip to main content

Connecting an email domain

Your emails come from addresses on your own domain, such as hello@mail.example.com. You connect the domain in the app, add the DNS records it shows, and add senders once it's verified.

You need

  • Access to your domain's DNS, usually where you bought the domain or at Cloudflare.
  • A role that can manage email settings: Owner, Admin, or a custom role with Manage Email Settings.

In the sandbox, any domain is verified at its first check, with no DNS records to add.

Connect the domain​

  1. Open Email › Domains and choose Connect Domain.
  2. Enter the domain, such as mail.example.com, and choose Connect Domain.

Use a subdomain, such as mail. or notify., so these emails don't affect the mail your team already sends from the main domain. A team can connect up to 10 domains.

Add the DNS records​

The domain's page lists the records to add, each with its Type, Name, Value and, for some, a Priority. Add each one where your domain's DNS is managed, exactly as shown. Some DNS hosts add the domain to the name themselves. If yours doesn't, add it.

RecordWhat it's forNeeded?
DKIMSigns each email, so inboxes know it came from you.Yes
SPFLets Ponitor send for the domain, and receive its bounces.Yes
DMARCTells inboxes what to do with email that fails the checks. Start with v=DMARC1; p=none;.Recommended

Check the records​

Choose Check Records on the domain's page. Most records are found within minutes, and some take up to 72 hours. Check again until the domain shows Verified.

Domain statuses​

StatusWhat it meansCan you send?
Waiting for DNSNo records found yet. Add them, then check.No
Checking DNSPonitor is looking for your records.No
VerifiedEvery record needed was found.Yes
Partly VerifiedYou can send, but one record is still missing.Yes
Record MissingA record that was found before is gone. Add it back within 72 hours to keep sending.Yes, for now
Not VerifiedThe records weren't found within 72 hours. Check that each name and value match exactly, then check again.No

Each record also shows its own status, such as Found or Not Found, so you can see which one is missing.

A domain is one team's at a time. If a domain isn't verified within 7 days, another team can connect it, so a team that doesn't own a domain can't keep its owner out. If another team has your domain, contact us.

Add a sender​

A sender is an address on the domain, with the name inboxes show. You can add senders once the domain is verified.

  1. On the domain's page, choose Add Sender.
  2. Enter the From Name, such as Acme, and the Address, the part before the @, such as hello.
  3. Add a Reply-To address if replies should go somewhere else. Without one, they go to the sender's address.

A domain can have up to 25 senders. To send from a sender through the API, put its address in from. See Sending email.

The default sender​

Your team has one default sender, across all its domains. The API sends from it when a request has no from, and Email › Send picks it first.

  • The first sender you add becomes the default.
  • To change it, choose Make Default in another sender's menu, or tick Default Sender when you add or edit one.
  • If you remove the default sender, make another one the default. Until you do, a request without from is refused with Add a sender under Email › Domains first.

Removing a domain​

Choose Remove Domain in the domain's menu. Its senders are removed with it, and a request that names one of them in from is refused with 404. Emails already sent aren't affected.