robotomaildocs
HomeAgent skillGet started

Custom domain setup

Add your own domain, configure DNS records, and verify for sending and receiving.

Prerequisites

  • A paid Robotomail plan (upgrade)
  • Access to your domain's DNS settings
  • A verified email address on your Robotomail account

1. Register the domain

curl
curl -X POST https://api.robotomail.com/v1/domains \
  -H "Authorization: Bearer $ROBOTOMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "yourdomain.com" }'

2. Configure DNS records

The response includes all DNS records to add at your registrar. You need to create:

  • 1 MX record — routes inbound email to Robotomail
  • 1 SPF TXT record — authorizes SES to send
  • 3 DKIM CNAME records — enables DKIM signing
  • 1 DMARC TXT record — sets authentication policy

DNS propagation typically takes 5-30 minutes, though it can take up to 48 hours.

3. Verify

Robotomail checks your DNS records automatically every 5 minutes. To trigger an immediate check:

curl
curl -X POST https://api.robotomail.com/v1/domains/DOMAIN_ID/verify \
  -H "Authorization: Bearer $ROBOTOMAIL_API_KEY"

Once all records verify, the domain status becomes VERIFIED and you can create mailboxes on it.

4. Create a mailbox on your domain

curl
curl -X POST https://api.robotomail.com/v1/mailboxes \
  -H "Authorization: Bearer $ROBOTOMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "address": "hello", "domainId": "DOMAIN_ID" }'