Domain Verification Guide

Using your own domain for sending emails increases deliverability and builds trust with your recipients. This guide explains how to verify and manage custom domains with Notify.

Domain Status Types

When you add a domain to Notify, it will have one of these status values:

StatusDescription
pendingDomain verification is in progress
verifiedDomain has been successfully verified
failedDomain verification has failed

DKIM (DomainKeys Identified Mail) also has status values:

StatusDescription
pendingDKIM verification is in progress
verifiedDKIM has been successfully verified
failedDKIM verification has failed

Managing Domains via Dashboard


  1. Go to the Domains Dashboard – Navigate to the Notify Domains Dashboard.
  2. Add Your Domain – Enter your domain and follow the setup instructions.
  3. Complete Verification – Add the provided DNS records to your domain settings.
  4. Get Higher Sending Limits – Once verified, your account automatically gains higher limits.

Managing Domains via API


List Your Domains

Retrieve all domains associated with your account:

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

Response

{
  "success": true,
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "domain": "example.com",
      "status": "verified",
      "dkimStatus": "verified",
      "createdAt": "2025-04-10T12:00:00Z",
      "verifiedAt": "2025-04-10T13:30:00Z",
      "updatedAt": "2025-04-10T13:30:00Z",
      "dmarcRecord": "v=DMARC1; p=reject; sp=reject; adkim=s; aspf=s;",
      "spfRecord": "v=spf1 include:example.com ~all"
    }
  ]
}

Get Domain Details

Retrieve details for a specific domain:

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

Using Verified Domains

Once your domain is verified, you can use it in the from field when sending emails either from the dashboard (automatically verified) or from the API:

fetch("https://notify.cx/api/public/v1/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."
  })
});

Important: You can only use domains with verified status. Emails sent from unverified domains will be rejected with an appropriate error message.

DNS Records Setup


To verify your domain, you'll need to add these DNS records:

  1. SPF Record: Specifies which mail servers are authorized to send email from your domain
  2. DKIM Record: Adds a digital signature to verify the authenticity of your emails
  3. DMARC Record: Tells receiving servers what to do with emails that don't pass SPF or DKIM checks

Detailed instructions for setting up these records will be provided in the Notify dashboard when you add a domain.

Troubleshooting Verification Issues


If your domain verification fails:

  1. Ensure DNS records are added exactly as specified
  2. Allow 24-48 hours for DNS propagation
  3. Check for typos in domain names or DNS records
  4. Verify you have permission to modify DNS settings for the domain
  5. Contact your DNS provider if records aren't updating correctly
  6. If the issue persists, please contact us for assistance.