Skip to main content

​
POST /domains

Add a domain for sending emails. Returns DNS records you need to configure at your domain registrar.

​
Authentication

JWT (Dashboard)

​
Request Body

FieldTypeRequiredDescription
domainstringYesDomain name (e.g. yourdomain.com)

​
Response

{
  "success": true,
  "data": {
    "domain": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "domain": "yourdomain.com",
      "status": "pending",
      "dns_records": [
        { "type": "TXT", "name": "_amazonses.yourdomain.com", "value": "..." },
        { "type": "CNAME", "name": "abc._domainkey.yourdomain.com", "value": "..." }
      ],
      "created_at": "2026-03-07T12:00:00Z"
    }
  },
  "message": "Domain added successfully. Please verify DNS records."
}

​
DNS Setup

After adding a domain, configure these DNS records at your registrar:
  1. TXT record — SES domain verification
  2. CNAME records (3) — DKIM signing
  3. MX record — For receiving bounces
  4. TXT record — SPF
  5. TXT record — DMARC
All records are returned in the dns_records array.

​
Limits

PlanMax Domains
Free1
Pro10