Domains
Send from your own domain, authenticated
Add a domain, publish the records we give you and start sending with DKIM, SPF, DMARC and Return-Path aligned. The records come formatted for your DNS panel.
- JSON commands
- DKIM 2048
- Zero-downtime key upgrade
- Auto-validation
- Registrar-aware hosts
https://g.sendcorex.com/v1/domaindomain:*How it works
Records ready to paste
We detect where your DNS is hosted and write each host the way that panel expects. Long DKIM values also come split for panels that need it.
Validated by itself
Every Get Domain checks the DNS live. The moment the Return-Path and DKIM are found, the domain is validated and you get an email.
Keys that age well
New domains get 2048-bit DKIM. Older 1024-bit keys move to 2048 on a new selector, with the old one signing until the new record is live.
Get started
Only the key is needed before your first request.
- 1
Create an API key with domain scopes
In the dashboard, open Developers → API Keys and give the key domain:read and domain:create. Add domain:delete only if it really needs to delete.
The webmail token does not work here. This API uses the dashboard API key.
- 2
Add the domain
Add Domain creates the DKIM key and returns the records to publish.
- 3
Publish and check
Create the records in your DNS panel, then call Get Domain until validated is true. After that, create senders on it.
The domain
Add Domain and Get Domain return the domain in this shape.
{
"domain": "news.acme.com",
"validated": false,
"has_mx": false,
"has_spf": false,
"has_dkim": false,
"has_dmarc": false,
"has_return_path": false,
"description": null,
"dkim_key_size": 2048,
"dkim_deprecated": false,
"dkim_upgrade_pending": false,
"created_at": "2026-10-21T03:02:15.441Z",
"updated_at": "2026-10-21T03:02:15.441Z",
"registrar": "cloudflare",
"dns_records": {
"spf": {
"type": "TXT",
"host": "news.acme.com",
"value": "v=spf1 include:smtp.emailsbit.com ~all"
},
"dkim": {
"type": "TXT",
"host": "sendcorex._domainkey.news",
"value": "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu1SU1LfVLPHCozMxH2Mo4lgOEePzNm0tRgeLezV6ffAt0gunVTLw7onLRnrq0/IzW7yWR7QkrmBL7jTKEn5u+qKhbwKfBstIs+bMY2Zkp18gnTxKLxoS2tFczGkPLPgizskuemMghRniWaoLcyehkd3qqGElvW/VDL5AaWTg0nLVkjRo9z+40RQzuVaE8AkAFmxZzow3x+VJYKdjykkJ0iT9wCS0DRTXu269V264Vf/3jvredZiKRkgwlL9xNAwxXFg0x/XFw005UWVRIkdgcKWTjpBP2dPwVZ4WWC+9aGVd+Gyn1o0CLelf4rEjGoXbAAEgAqeGUxrcIlbjXfbcmwIDAQAB",
"split_value": "\"v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu1SU1LfVLPHCozMxH2Mo4lgOEePzNm0tRgeLezV6ffAt0gunVTLw7onLRnrq0/IzW7yWR7QkrmBL7jTKEn5u+qKhbwKfBstIs+bMY2Zkp18gnTxKLxoS2tFczGkPLPgizskuemMghRniWaoLcyehkd3qqGElvW/VDL5AaWTg0nLVkjRo9z+40RQzuVaE8AkAF\" \"mxZzow3x+VJYKdjykkJ0iT9wCS0DRTXu269V264Vf/3jvredZiKRkgwlL9xNAwxXFg0x/XFw005UWVRIkdgcKWTjpBP2dPwVZ4WWC+9aGVd+Gyn1o0CLelf4rEjGoXbAAEgAqeGUxrcIlbjXfbcmwIDAQAB\""
},
"mx": {
"type": "MX",
"host": "news.acme.com",
"value": "bounce.emailsbit.com",
"priority": 0
},
"return_path": {
"type": "CNAME",
"host": "bounces.news",
"value": "bounce.emailsbit.com"
},
"dmarc": {
"type": "TXT",
"host": "_dmarc.news",
"value": "v=DMARC1; p=none; rua=mailto:dmarc@bounces.news.acme.com"
}
},
"spf_duplicate": false,
"spf_duplicate_records": [],
"dkim": {
"version": 2,
"key_size": 2048,
"selector": "sendcorex",
"deprecated": false,
"upgrade_pending": false,
"pending": null,
"previous_selector": null,
"keep_old_record_until": null,
"just_upgraded": false
}
}validatedtrue once the Return-Path and DKIM records are found. Only validated domains can have senders.
dns_recordsSPF, DKIM, MX, Return-Path and DMARC, each with type, host and value. Return-Path and DKIM are the required ones.
registrarWhere your DNS is hosted. It decides if host is relative (Cloudflare, Namecheap…) or the full name (GoDaddy…).
dkimThe key in use, its size and any upgrade in progress.
Your first request
Add a subdomain for your newsletters. Replace SENDCOREX_API_KEY with your API key.
curl -X POST 'https://g.sendcorex.com/v1/domain' \
-H "Authorization: $SENDCOREX_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"commands": [
{ "command": "add_domain", "args": { "domain": "news.acme.com" } }
]
}'You get the records to publish. Publish them, then call get_domain with the same domain until validated is true. The same request in 8 languages is in Add Domain.
Common tasks
Onboard customers inside your app
Add their domain from your own UI, show the records, and poll Get Domain until it turns green.
Waiting for the DNSHand the DNS to someone else
Email the exact records to the IT team or agency that manages the domain.
Send DNS InstructionsUpgrade old 1024-bit keys
Find domains with dkim_deprecated and move them to 2048 bits without a minute of failed DKIM.
How the upgrade worksSend before your domain is ready
Create a sender on a shared domain we already verified, and switch to yours later.
List Free DomainsFull reference
Everything marked CMD is a command sent through POST /v1/domain, up to 10 per request.