robotomaildocs
HomeAgent skillGet started

Custom Domains

Send and receive email from your own domain instead of *.robotomail.com.

Platform subdomain vs custom domain

By default, every account gets a platform subdomain: slug.robotomail.com. Mailboxes on this subdomain work immediately with no DNS configuration.

Custom domains let you send from addresses like [email protected]. This requires the paid plan, DNS configuration, and domain verification.

Required DNS records

  • MX record — Points your domain to Robotomail's inbound mail server
  • SPF (TXT) — Authorizes Amazon SES to send on your behalf: v=spf1 include:amazonses.com ~all
  • DKIM (3 CNAMEs) — SES provides three CNAME records for DKIM signing. These prove emails are unmodified and authorized.
  • DMARC (TXT) — Policy for handling authentication failures: v=DMARC1; p=quarantine; adkim=s; aspf=s

Verification process

After adding a domain via POST /v1/domains, you receive the DNS records to configure. A background job checks verification every 5 minutes, or you can trigger it manually via POST /v1/domains/:id/verify.

Once all four record types are verified, the domain status changes to VERIFIED and you can create mailboxes on it.