Send email from your own domain

Until you verify a domain, your project's email is sent from a shared sender address. Verify your own domain to send as [email protected] instead, with your brand in the From line and better deliverability for your recipients.

Add and verify a domain

1. Open Transactional Mail in your project.
2. Under Verify Your Own Domain, enter your domain and choose Add Domain.
3. The domain is created and shown with a table of DNS records: Type, Name, Value and Status.
4. Add each record at your DNS provider, exactly as shown.
5. Choose Check Verification. The domain's badge changes from Pending DNS to Verified, and individual records show whether each is valid.

If a record is still missing, wait a little. DNS changes can take a while to spread. Then check again. For background on these records, see MX, SPF, DKIM and DMARC records explained and Verify DNS records.

Choose Remove to take a domain off the project.

After it is verified

Mail from your project now defaults to [email protected]. You can pass your own from address on a request, as long as it is on a domain you have verified, such as [email protected]. A from on any other domain is replaced by the default sender, which stops anyone using your project to send as someone else.

The Active Mail Provider on the page changes from Managed Sandbox Pool to Verified Custom Domain.

Your own mail server

If you prefer, the Advanced: Bring Your Own section lets you enter the host, port, username and password of your own outgoing mail server, plus a Custom From Email. Save the settings at the bottom of that section. Leave the host empty to use the managed pool instead. When it is on, the Active Mail Provider shows it as custom and your messages go through your server. There is no platform fee for this, and delivery, limits and reputation become your server's responsibility.

From code

With a secret key you can also manage domains over the API: GET /mail/domains to list, POST /mail/domains with {"domain": "yourdomain.com"} to add one.

Good to know

• Authentication emails have their own sender domain setting: see Send authentication emails from your own domain. A verified authentication domain can be copied to Transactional Mail with Use for PGB Mail (needs approval) once mail access is approved.
• Keep the DNS records in place. If they are removed, the domain stops verifying and mail falls back to the shared sender.