Domain Verification Guide

Verify a custom domain to send production email from your own address.

Sending from your own domain improves deliverability and builds trust with recipients. Verify your domain before using a custom from address in production.

New accounts can send test emails immediately via the sandbox. Production API sends with a custom from address require a verified domain.

Domain limits by plan

| Plan | Verified domains | | --- | --- | | Free | 1 | | Pro | 3 | | Scale | 10 |

Domain status values

StatusDescription
pendingVerification in progress
verifiedDomain verified — ready for production sends
failedVerification failed — check DNS records

Verify via dashboard

  1. Open the Domains dashboard
  2. Add your domain
  3. Add the DNS records Notify provides (SPF, DKIM, DMARC)
  4. Wait for verification — DNS propagation can take 24–48 hours

Verify via API

List domains:

curl -X GET https://notify.cx/api/public/v1/domains \
  -H "x-api-key: your_api_key"

Get a specific domain:

curl -X GET https://notify.cx/api/public/v1/domains/example.com \
  -H "x-api-key: your_api_key"

Send from a verified domain

Once verified, pass from in your send request:

await fetch('https://notify.cx/api/email/send', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.NOTIFY_API_KEY!
  },
  body: JSON.stringify({
    from: 'noreply@your-verified-domain.com',
    to: 'recipient@example.com',
    subject: 'Hello from your domain',
    message: 'This email is sent from your verified domain.'
  })
});

Emails sent from unverified domains are rejected.

DNS records

Notify requires three record types:

  1. SPF — authorizes Notify to send on your behalf
  2. DKIM — signs outgoing messages
  3. DMARC — tells receivers how to handle authentication failures

Exact values are shown in the dashboard when you add a domain.

Troubleshooting

If verification fails:

  1. Confirm DNS records match exactly what Notify provided
  2. Allow 24–48 hours for propagation
  3. Check for typos in record names or values
  4. Verify you can edit DNS for the domain
  5. Contact hello@notify.cx if the issue persists

Next steps