Domains API

Manage your sending domains programmatically.

Required permission: admin

---

List domains

GET /api/v1/domains

Returns all verified and pending domains for your organization.

curl https://api.emitlo.com/api/v1/domains \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

{
  "status": "success",
  "data": {
    "domains": [
      {
        "id": 1,
        "domain": "yourdomain.com",
        "mailfrom_subdomain": "mail.yourdomain.com",
        "status": "verified",
        "created_at": "2026-01-10T09:00:00Z"
      }
    ]
  }
}

---

Add domain

POST /api/v1/domains

Adds a new sending domain. Emitlo automatically generates DKIM keys and publishes DNS records.

curl -X POST https://api.emitlo.com/api/v1/domains \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "yourdomain.com",
    "mailfrom_subdomain": "mail.yourdomain.com"
  }'

Field	Type	Required	Description
domain	string	✅	Root domain to add (e.g. yourdomain.com)
mailfrom_subdomain	string	—	MAIL FROM subdomain. Defaults to mail.{domain}

Response (201):

{
  "status": "success",
  "data": {
    "domain": {
      "id": 2,
      "domain": "yourdomain.com",
      "status": "pending"
    },
    "dns_records": [
      {
        "type": "CNAME",
        "name": "abc123-1._domainkey.yourdomain.com",
        "value": "abc123-1.dkim.emitlo.com",
        "purpose": "DKIM CNAME 1"
      },
      {
        "type": "CNAME",
        "name": "abc123-2._domainkey.yourdomain.com",
        "value": "abc123-2.dkim.emitlo.com",
        "purpose": "DKIM CNAME 2"
      },
      {
        "type": "TXT",
        "name": "mail.yourdomain.com",
        "value": "v=spf1 include:spf.emitlo.com ~all",
        "purpose": "SPF"
      },
      {
        "type": "MX",
        "name": "mail.yourdomain.com",
        "value": "10 return.emitlo.com",
        "purpose": "MX (bounce routing)"
      }
    ]
  }
}

Note

Add all DNS records to your registrar, then trigger verification. DNS propagation typically takes a few minutes but can take up to 48 hours.

---

Get DNS records

GET /api/v1/domains/{id}/dns-records

Returns the current DNS records and their verification status.

curl https://api.emitlo.com/api/v1/domains/2/dns-records \
  -H "Authorization: Bearer YOUR_API_KEY"

---

Verify domain

POST /api/v1/domains/{id}/verify

Triggers an immediate DNS verification check.

curl -X POST https://api.emitlo.com/api/v1/domains/2/verify \
  -H "Authorization: Bearer YOUR_API_KEY"

See Domain Setup Guide for the full setup walkthrough.