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:
Status | Description |
---|---|
pending | Domain verification is in progress |
verified | Domain has been successfully verified |
failed | Domain verification has failed |
DKIM (DomainKeys Identified Mail) also has status values:
Status | Description |
---|---|
pending | DKIM verification is in progress |
verified | DKIM has been successfully verified |
failed | DKIM verification has failed |
Managing Domains via Dashboard
- Go to the Domains Dashboard – Navigate to the Notify Domains Dashboard.
- Add Your Domain – Enter your domain and follow the setup instructions.
- Complete Verification – Add the provided DNS records to your domain settings.
- 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:
- SPF Record: Specifies which mail servers are authorized to send email from your domain
- DKIM Record: Adds a digital signature to verify the authenticity of your emails
- 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:
- Ensure DNS records are added exactly as specified
- Allow 24-48 hours for DNS propagation
- Check for typos in domain names or DNS records
- Verify you have permission to modify DNS settings for the domain
- Contact your DNS provider if records aren't updating correctly
- If the issue persists, please contact us for assistance.