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
- Open Email › Domains and choose Connect Domain.
- 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.
| Record | What it's for | Needed? |
|---|---|---|
| DKIM | Signs each email, so inboxes know it came from you. | Yes |
| SPF | Lets Ponitor send for the domain, and receive its bounces. | Yes |
| DMARC | Tells 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
| Status | What it means | Can you send? |
|---|---|---|
| Waiting for DNS | No records found yet. Add them, then check. | No |
| Checking DNS | Ponitor is looking for your records. | No |
| Verified | Every record needed was found. | Yes |
| Partly Verified | You can send, but one record is still missing. | Yes |
| Record Missing | A record that was found before is gone. Add it back within 72 hours to keep sending. | Yes, for now |
| Not Verified | The 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.
- On the domain's page, choose Add Sender.
- Enter the From Name, such as
Acme, and the Address, the part before the @, such ashello. - 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
fromis refused withAdd 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.