Skip to main content

Domains

Configure and verify domains to send emails with Lettr.

Why Verify Domains?

Domain verification is essential for:
  • Deliverability - Properly authenticated emails reach the inbox
  • Brand Trust - Send from your own domain, not a shared one
  • Compliance - Meet email authentication requirements (SPF, DKIM, DMARC)

Add a Domain

1

Add Domain in Dashboard

Go to Domains → Add Domain and enter your domain name.
2

Add DNS Records

Add the provided DNS records to your domain.
3

Verify Domain

Click Verify to confirm DNS propagation.

Via API

const domain = await lettr.domains.create({
  name: 'example.com'
});

// Get DNS records to add
console.log(domain.dnsRecords);

Required DNS Records

TypeNameValuePurpose
TXT@v=spf1 include:spf.lettr.dev ~allSPF authentication
CNAMElettr._domainkeydkim.lettr.devDKIM signing
TXT_dmarcv=DMARC1; p=none;DMARC policy

Check Domain Status

const domain = await lettr.domains.get('dom_123');

console.log({
  spfStatus: domain.spfStatus,    // 'verified', 'pending', 'failed'
  dkimStatus: domain.dkimStatus,  // 'verified', 'pending', 'failed'
  dmarcStatus: domain.dmarcStatus // 'verified', 'pending', 'failed'
});

Domain Status

StatusDescription
pendingDNS records not yet detected
verifiedAll records verified and active
failedVerification failed (check DNS)

Learn More