Skip to main content

​
Adding Domains

To send emails from your own domain (e.g., [email protected]), you need to verify ownership and configure DNS records for best deliverability (SPF, DKIM, DMARC).

​
1. Add Domain

Use the dashboard or the SDK to register your domain. 
const { domain } = await client.domains.addDomain({
  domain: 'acme.com'
});

console.log(domain.records); // -> List of DNS records to add

​
2. Configure DNS

We will provide you with a set of DNS records. You must add these to your DNS provider (Cloudflare, GoDaddy, AWS Route53, etc.).
TypeNameValuePurpose
TXTemail._domainkeyk=rsa; ...DKIM: Signs your emails (Crucial)
TXT@v=spf1 include:...SPF: Authorizes us to send
TXT_dmarcv=DMARC1; ...DMARC: Policy for unauth emails
DNS changes can take anywhere from a few minutes to 24 hours to propagate. We automatically check for updates every few minutes.

​
3. Verify

Once you’ve added the records, you can trigger an immediate check: 
const { domain } = await client.domains.verifyDomain({
  id: 'dom_123...'
});

if (domain.status === 'DOMAIN_STATUS_READY') {
  console.log('Ready to send!');
}

​
Domain Statuses

Domain has been added but DNS records haven’t been verified yet.
We’re actively checking your DNS records.
All DNS records verified. You can send emails from this domain.
Verification failed. Check your DNS settings and try again.