Skip to main content
Concepts

Domains and DNS

Why the sender needs a verified domain and which records to publish.

Records

When you add a domain, the API returns the records you publish in DNS. The dashboard shows the same values, ready to copy.

  • SPF: authorizes CoffeeMail to send for the domain.
  • DKIM: signs every message with the selector key.
  • DMARC: tells providers what to do with messages failing SPF and DKIM.
DNS
acme.com.br                  TXT  "v=spf1 include:_spf.coffeemail.com.br ~all"cm1._domainkey.acme.com.br   TXT  "v=DKIM1; k=rsa; p=MIIBIjANBgkqh…"_dmarc.acme.com.br           TXT  "v=DMARC1; p=quarantine; rua=mailto:dmarc@acme.com.br"

Verification

After publishing, call POST /domains/{id}/verify or wait for the automatic check. Until the domain is verified, sends using it in from return DOMAIN_NOT_VERIFIED.

The API keeps checking DNS periodically. If a record disappears, the domain gets an alert and you are warned before sends fail.

Tracking and warm-up

A tracking domain of your own (CNAME) brands the click links. New domains go through warm-up: the daily limit rises gradually to protect reputation.