Custom Domains
Add custom sending domains to send emails from your own domain (e.g., hello@yourdomain.com) instead of the default SendComms address. Custom domains improve deliverability and brand recognition.
How Custom Domains Work
Add your domain
Register your sending domain (e.g., mail.yourdomain.com) via the API or dashboard
Configure DNS records
Add the provided SPF, DKIM, and optional DMARC records to your DNS provider
Verify your domain
Trigger verification to check DNS propagation (can take up to 72 hours)
Start sending
Once verified, emails will automatically use your domain. You can also specify a custom "from" address.
Domain Status Values
| Status | Description |
|---|---|
| not_started | Domain added but verification not yet initiated |
| pending | Verification in progress, waiting for DNS propagation |
| verified | Domain verified and ready to send emails |
| failed | DNS records not detected within 72 hours |
| temporary_failure | DNS records temporarily not detected, will retry automatically |
Select Language
List all domains for your account.
curl -X GET \
https://api.sendcomms.com/api/v1/domains \
-H "Authorization: Bearer YOUR_API_KEY"Add a new sending domain. Returns DNS records that must be added to your DNS provider.
Request Body
| Parameter | Type | Description |
|---|---|---|
| name | string | Domain name (e.g., mail.yourdomain.com) |
| region | string | us-east-1, eu-west-1, sa-east-1, or ap-northeast-1 |
curl -X POST \
https://api.sendcomms.com/api/v1/domains \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "mail.yourdomain.com",
"region": "us-east-1"
}'Trigger DNS verification for a domain. Call this after adding DNS records.
curl -X POST \
https://api.sendcomms.com/api/v1/domains/YOUR_DOMAIN_ID/verify \
-H "Authorization: Bearer YOUR_API_KEY"Other Endpoints
Required DNS Records
When you create a domain, you'll receive DNS records to add to your DNS provider. These typically include:
MX and TXT records
Authorizes SendComms to send on your behalf
3 CNAME records
Cryptographically signs your emails for authenticity
TXT record (recommended)
Improves deliverability and provides reporting