curl --request POST \
--url https://app.sendmux.ai/api/v1/domains \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"domain": "mail.acme.com"
}
'{
"ok": true,
"data": {
"id": "mdom_clxxxxxxxxxxxxxxxxxxxxxxxxx",
"domain": "mail.acme.com",
"verification_status": "pending",
"ses_dkim_status": "<string>",
"verified_at": "<string>",
"created_at": "<string>",
"dns_records": {
"mx": [
{
"priority": 10,
"target": "mail.sendmux.ai"
}
],
"spf": {
"name": "_sendmux.acme.com",
"value": "sendmux-verify=team_abc123"
},
"dmarc": {
"name": "_sendmux.acme.com",
"value": "sendmux-verify=team_abc123"
},
"dkim": [
{
"name": "_sendmux.acme.com",
"value": "sendmux-verify=team_abc123"
}
],
"verification": {
"name": "_sendmux.acme.com",
"value": "sendmux-verify=team_abc123"
}
}
},
"meta": {
"request_id": "req_clxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}Creates a new sending domain and returns the DNS records the customer must place before verification can succeed. Provisioning touches both our mail platform and Amazon SES — on any failure the partial state is automatically rolled back.
curl --request POST \
--url https://app.sendmux.ai/api/v1/domains \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"domain": "mail.acme.com"
}
'{
"ok": true,
"data": {
"id": "mdom_clxxxxxxxxxxxxxxxxxxxxxxxxx",
"domain": "mail.acme.com",
"verification_status": "pending",
"ses_dkim_status": "<string>",
"verified_at": "<string>",
"created_at": "<string>",
"dns_records": {
"mx": [
{
"priority": 10,
"target": "mail.sendmux.ai"
}
],
"spf": {
"name": "_sendmux.acme.com",
"value": "sendmux-verify=team_abc123"
},
"dmarc": {
"name": "_sendmux.acme.com",
"value": "sendmux-verify=team_abc123"
},
"dkim": [
{
"name": "_sendmux.acme.com",
"value": "sendmux-verify=team_abc123"
}
],
"verification": {
"name": "_sendmux.acme.com",
"value": "sendmux-verify=team_abc123"
}
}
},
"meta": {
"request_id": "req_clxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}Sendmux API key. Obtain from the dashboard under API Keys. Format: smx_root_...
Fully qualified domain name. Must be lowercased and hostname-only (no scheme).
"mail.acme.com"
Created domain
true Hide child attributes
Public ID
"mdom_clxxxxxxxxxxxxxxxxxxxxxxxxx"
Fully qualified domain name
"mail.acme.com"
Current verification state
pending, verified, failed SES DKIM status (pending/success/failed/temporary_failure/not_started)
ISO 8601 timestamp of last successful verification
ISO 8601 creation timestamp
Hide child attributes
Was this page helpful?