Skip to main content
POST
/
domain
Create domain
curl --request POST \
  --url https://api.sendx.io/api/v1/rest/domain \
  --header 'Content-Type: application/json' \
  --header 'X-Team-ApiKey: <api-key>' \
  --data '
{
  "name": "Example.com"
}
'
{
  "id": "domain_504",
  "name": "sx13.email",
  "verified": false,
  "returnPathVerified": false,
  "dkimVerified": false,
  "trackVerified": false,
  "dmarcVerified": false,
  "gptVerified": false,
  "dkim": {
    "host": "sp-dkim._domainkey.sx13.email",
    "type": "TXT",
    "textValue": "v=DKIM1;k=rsa;s=email;h=sha256;p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC94euUPiD9e9jO4rgnjWYSa6YOcYz24SkrNPJ6u9AaeDG8Zvwu3om4sxkGrQ3vO1hoX9RQnccBCM9y+9Z6fCFmwI6eGjtskxLPLThMSsjDACL3iI1UYTZyuSHEk67QoLsgSmcTTtVjBGdtPi2w6SsXOauXav07wB7VPuDL/Q1zOQIDAQAB"
  },
  "returnPath": {
    "host": "sp-bounce.sx13.email",
    "type": "CNAME",
    "textValue": "sp.sendpost.info"
  },
  "track": {
    "host": "sp-track.sx13.email",
    "type": "CNAME",
    "textValue": "track.sptrackh.com"
  },
  "dmarc": {
    "host": "_dmarc.sx13.email",
    "type": "TXT",
    "textValue": "v=DMARC1; p=none;"
  },
  "gpt": {
    "host": "sx13.email",
    "type": "TXT",
    "textValue": ""
  },
  "dkimConfig": "{\"Domain\":\"sx13.email\",\"PubKey\":\"MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC94euUPiD9e9jO4rgnjWYSa6YOcYz24SkrNPJ6u9AaeDG8Zvwu3om4sxkGrQ3vO1hoX9RQnccBCM9y+9Z6fCFmwI6eGjtskxLPLThMSsjDACL3iI1UYTZyuSHEk67QoLsgSmcTTtVjBGdtPi2w6SsXOauXav07wB7VPuDL/Q1zOQIDAQAB\",\"PrivKey\":\"-----BEGIN RSA PRIVATE KEY-----\\nMIICXAIBAAKBgQC94euUPiD9e9jO4rgnjWYSa6YOcYz24SkrNPJ6u9AaeDG8Zvwu\\n3om4sxkGrQ3vO1hoX9RQnccBCM9y+9Z6fCFmwI6eGjtskxLPLThMSsjDACL3iI1U\\nYTZyuSHEk67QoLsgSmcTTtVjBGdtPi2w6SsXOauXav07wB7VPuDL/Q1zOQIDAQAB\\nAoGAH2MFvtZaO6xKFUCSsi8ETU0wALkyVOi5FmRFJJaA+q8dgYgAbXrphvdLzrey\\nUvYbUf1tKfo6l+gt6lLIjCySlJFUkFbHeQlch+ZfhvyCP+2zo6JrFSRosZGYsZhb\\ncBnnfzi+r6FDCiobLn8Y78eEli0RX7lvUC4VSJ6J2vTiybUCQQDJQqWqvPe8vdr+\\neHioA7YeWiCInhHD6ylKMqCwFTkdjbhUoK5rZmnQJ2xmAljEz7pdpgxeg8oNFLfO\\namXLKGSfAkEA8YcOmAC3sdTXYMptwnQ4Y4IOOaY/0HXM6YEnmRbN526CBRciUdj/\\ndoc24g+Ibx5IVPRkQBWuWiB6OIP5wY6BJwJAA93G5vfIXpTbHyZbUwb3ObALjfRT\\nbQsYePduBNPzi/DMCLwpfaCzCa+oMnF7GRTQhLoK5MntWMD8IvgCSpvVCwJAHhZY\\n9w5/06NUATa2XZbkv2CgLQZMxMcn856nNCbnF4FoqQGswM1rZXSKnbaZpF39XLfl\\nFSaeRZPuJcQrBLWf2QJBAKAakfXcnF3N5v37r3TMl31vrMyBBSihKTxs3y5b+JqQ\\nINkXkhATSdxwZzwLHbkGmzNVgrCTX5+ZrpxS9jTAUBE=\\n-----END RSA PRIVATE KEY-----\\n\",\"Selector\":\"sp-dkim\",\"Headers\":\"\"}",
  "dmarcFailureReason": "",
  "created": 1764924919882212400,
  "updated": 0
}
🎯 Purpose: Domains are essential for email authentication and deliverability. Creating a domain allows you to:
  • Authenticate your email sending domain
  • Configure DNS records for email security
  • Improve sender reputation and deliverability
  • Set up custom tracking domains
💡 Use Cases:
  • Branded email sending (newsletter@yourdomain.com)
  • Custom tracking domains for analytics
  • Multiple domain management for different brands
  • Subdomain management (mail.yourdomain.com)
🔧 DNS Configuration: After creating a domain, you’ll need to configure DNS records:
  1. DKIM - DomainKeys Identified Mail for email signing
  2. SPF - Sender Policy Framework for sender authorization
  3. DMARC - Domain-based Message Authentication for policy enforcement
  4. Return Path - Bounce handling configuration
  5. Tracking Domain - Custom tracking for email analytics
⚡ Best Practices:
  • Use your primary business domain for better reputation
  • Complete all DNS verifications before sending
  • Monitor verification status regularly
  • Keep DNS records updated and valid
  • Use subdomains for different email purposes (marketing, transactional)
🔒 Security Tips:
  • Verify all DNS records are correctly configured
  • Regularly check DMARC reports
  • Monitor domain reputation
  • Keep domain registration active

Authorizations

​
X-Team-ApiKey
string
header
required

Team API key for authentication. Find your API key in SendX Settings → Team API Key.

Example:

X-Team-ApiKey: your_team_api_key_here

Body

application/json
​
name
string
required

Domain name (e.g., example.com)

Example:

"Example.com"

Response

✅ Domain created successfully

​
id
string

Unique domain identifier with domain_ prefix

Pattern: ^domain_[a-zA-Z0-9]{22}$
Example:

"domain_504"

​
name
string

Domain name

Example:

"sx13.email"

​
verified
boolean

Overall domain verification status

Example:

false

​
returnPathVerified
boolean

Return path (bounce) verification status

Example:

false

​
dkimVerified
boolean

DKIM verification status

Example:

false

​
trackVerified
boolean

Tracking domain verification status

Example:

false

​
dmarcVerified
boolean

DMARC verification status

Example:

false

​
gptVerified
boolean

GPT (Google Postmaster Tools) verification status

Example:

false

​
dkim
object

DKIM DNS record configuration

​
returnPath
object

Return path (bounce) DNS record configuration

​
track
object

Tracking domain DNS record configuration

​
dmarc
object

DMARC DNS record configuration

​
gpt
object

GPT (Google Postmaster Tools) DNS record configuration

​
dkimConfig
string

DKIM configuration in JSON format

Example:

"{\"Domain\":\"sx13.email\",\"PubKey\":\"MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC94euUPiD9e9jO4rgnjWYSa6YOcYz24SkrNPJ6u9AaeDG8Zvwu3om4sxkGrQ3vO1hoX9RQnccBCM9y+9Z6fCFmwI6eGjtskxLPLThMSsjDACL3iI1UYTZyuSHEk67QoLsgSmcTTtVjBGdtPi2w6SsXOauXav07wB7VPuDL/Q1zOQIDAQAB\",\"PrivKey\":\"-----BEGIN RSA PRIVATE KEY-----\\nMIICXAIBAAKBgQC94euUPiD9e9jO4rgnjWYSa6YOcYz24SkrNPJ6u9AaeDG8Zvwu\\n3om4sxkGrQ3vO1hoX9RQnccBCM9y+9Z6fCFmwI6eGjtskxLPLThMSsjDACL3iI1U\\nYTZyuSHEk67QoLsgSmcTTtVjBGdtPi2w6SsXOauXav07wB7VPuDL/Q1zOQIDAQAB\\nAoGAH2MFvtZaO6xKFUCSsi8ETU0wALkyVOi5FmRFJJaA+q8dgYgAbXrphvdLzrey\\nUvYbUf1tKfo6l+gt6lLIjCySlJFUkFbHeQlch+ZfhvyCP+2zo6JrFSRosZGYsZhb\\ncBnnfzi+r6FDCiobLn8Y78eEli0RX7lvUC4VSJ6J2vTiybUCQQDJQqWqvPe8vdr+\\neHioA7YeWiCInhHD6ylKMqCwFTkdjbhUoK5rZmnQJ2xmAljEz7pdpgxeg8oNFLfO\\namXLKGSfAkEA8YcOmAC3sdTXYMptwnQ4Y4IOOaY/0HXM6YEnmRbN526CBRciUdj/\\ndoc24g+Ibx5IVPRkQBWuWiB6OIP5wY6BJwJAA93G5vfIXpTbHyZbUwb3ObALjfRT\\nbQsYePduBNPzi/DMCLwpfaCzCa+oMnF7GRTQhLoK5MntWMD8IvgCSpvVCwJAHhZY\\n9w5/06NUATa2XZbkv2CgLQZMxMcn856nNCbnF4FoqQGswM1rZXSKnbaZpF39XLfl\\nFSaeRZPuJcQrBLWf2QJBAKAakfXcnF3N5v37r3TMl31vrMyBBSihKTxs3y5b+JqQ\\nINkXkhATSdxwZzwLHbkGmzNVgrCTX5+ZrpxS9jTAUBE=\\n-----END RSA PRIVATE KEY-----\\n\",\"Selector\":\"sp-dkim\",\"Headers\":\"\"}"

​
dmarcFailureReason
string

Reason for DMARC verification failure (if any)

Example:

""

​
created
integer<int64>

Domain creation timestamp (nanoseconds since epoch)

Example:

1764924919882212400

​
updated
integer<int64>

Domain last update timestamp (nanoseconds since epoch)

Example:

0