Custom Domain Email

Host email on your own domain — DKIM, SPF, DMARC, IMAP, SMTP. Add a domain, set DNS, verify, then create accounts. Pro+ plans only.

1. Add a mail domain

curl -X POST $API/{slug}/mail/domains \
  -H "X-API-Key: $KEY" \
  -d '{"domain":"mycompany.com"}'

Response includes the DNS records you need to publish — MX, SPF, DKIM, DMARC.

2. Publish DNS records

Add the returned records at your DNS host (Cloudflare, Route53, Namecheap, whatever). Then verify:

curl -X POST $API/{slug}/mail/domains/mycompany.com/verify \
  -H "X-API-Key: $KEY"

3. Create accounts

curl -X POST $API/{slug}/mail/accounts \
  -H "X-API-Key: $KEY" \
  -d '{
    "email": "hello@mycompany.com",
    "password": "securepass",
    "display_name": "Hello"
  }'

Access the mailbox

• IMAP — mail.mosaic.site:993 SSL, sign in with the account email + password
• SMTP — mail.mosaic.site:465 SSL, same credentials

List + stats

curl $API/{slug}/mail/accounts -H "X-API-Key: $KEY"
curl $API/{slug}/mail/stats    -H "X-API-Key: $KEY"

Endpoints