Custom domains — CarlyEmail docs

Using your own domain means recipients see your brand, and your sending reputation is yours rather than shared.

curl -X POST https://api.carlyemail.com/v0/domains \
  -H "Authorization: Bearer $CARLYEMAIL_API_KEY" \
  -H 'content-type: application/json' \
  -d '{"name": "mail.yourcompany.com"}'

The response lists the DNS records to publish — DKIM signing keys, a MAIL FROM record, DMARC, and MX if you want to receive.

Publish them, then:

curl -X POST https://api.carlyemail.com/v0/domains/$DOMAIN_ID/verify \
  -H "Authorization: Bearer $CARLYEMAIL_API_KEY"

DNS takes minutes to hours to propagate. Verification is safe to retry.

Tip

Use a subdomain — mail.yourcompany.com rather than the apex. If sending reputation ever goes wrong, a subdomain can be retired without affecting your main domain's mail.

Once verified, create inboxes with domain set to it.

What we check

DKIM and MAIL FROM are attested by the sending provider. DMARC and inbound MX we resolve directly, because the provider has no opinion on those two and a domain that looks verified but cannot receive is worse than one that plainly is not.