Domains

Configure sending domains for email delivery.

Verifying a domain adds DKIM and SPF records, improving deliverability and ensuring your emails don’t land in spam.

GET/api/v1/domains

List all sending domains configured for your organization.

Example

curl https://app.clawdmail.ai/api/v1/domains \
  -H "Authorization: Bearer cm_live_your_key"

Response

{
  "data": {
    "domains": [
      {
        "id": "dom_4a2b8c1d3e5f",
        "domain": "mail.example.com",
        "status": "verified",
        "dkimStatus": "verified",
        "spfStatus": "verified",
        "createdAt": "2026-01-20T10:00:00Z"
      }
    ]
  }
}

POST/api/v1/domains

Add a new sending domain. After creation, you'll need to add the returned DNS records to your domain provider, then call the verify endpoint.

Parameters

Name	Type	Description
`domain`required	string	The domain to configure for sending (e.g. "mail.example.com")

Example

curl -X POST https://app.clawdmail.ai/api/v1/domains \
  -H "Authorization: Bearer cm_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "mail.example.com" }'

Response

{
  "data": {
    "id": "dom_9e7d6c5b4a3f",
    "domain": "mail.example.com",
    "status": "pending",
    "dnsRecords": [
      {
        "type": "CNAME",
        "name": "cm._domainkey.mail.example.com",
        "value": "dkim.clawdmail.ai"
      },
      {
        "type": "TXT",
        "name": "mail.example.com",
        "value": "v=spf1 include:spf.clawdmail.ai ~all"
      }
    ],
    "createdAt": "2026-03-04T12:00:00Z"
  }
}

GET/api/v1/domains/:id

Retrieve a single domain with its current verification status and DNS records.

Parameters

Name	Type	Description
`id`required	string	Domain ID

Example

curl https://app.clawdmail.ai/api/v1/domains/dom_9e7d6c5b4a3f \
  -H "Authorization: Bearer cm_live_your_key"

Verify Domain

POST/api/v1/domains/:id/verify

Trigger DNS verification for a domain. ClawdMail will check that the required DKIM and SPF records are correctly configured.

Parameters

Name	Type	Description
`id`required	string	Domain ID

Example

curl -X POST https://app.clawdmail.ai/api/v1/domains/dom_9e7d6c5b4a3f/verify \
  -H "Authorization: Bearer cm_live_your_key"

Response

{
  "data": {
    "id": "dom_9e7d6c5b4a3f",
    "domain": "mail.example.com",
    "status": "verified",
    "dkimStatus": "verified",
    "spfStatus": "verified"
  }
}

DNS propagation can take up to 48 hours. If verification fails, wait and try again.

DELETE/api/v1/domains/:id

Remove a sending domain from your organization. Campaigns using this domain will fall back to the default ClawdMail sending domain.

Parameters

Name	Type	Description
`id`required	string	Domain ID

Example

curl -X DELETE https://app.clawdmail.ai/api/v1/domains/dom_9e7d6c5b4a3f \
  -H "Authorization: Bearer cm_live_your_key"

Response

{
  "data": {
    "deleted": true
  }
}