Get started
Browse the docs

Domains

Create a domain

Register a domain and get the DNS records to publish.

POST/api/v1/domains
cURL
curl -X POST "https://inboundr.net/api/v1/domains" \
  -H "Authorization: Bearer $INBOUNDR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "<domain>"
  }'

Registers a domain and returns the MX and DKIM records to add at your DNS host. The domain starts pending and verifies automatically once the records are observed. See Domains.

domainstringbodyrequired

The domain name, e.g. yourdomain.com. Lowercased; must be a valid public domain.

Example response

201
{
  "id": "dom_123",
  "domain": "yourdomain.com",
  "status": "pending",
  "dkimTokens": ["token1", "token2", "token3"],
  "dnsRecords": [
    { "type": "MX", "name": "yourdomain.com", "value": "…", "priority": 10 },
    { "type": "CNAME", "name": "token1._domainkey.yourdomain.com", "value": "…" }
  ],
  "createdAt": "2026-07-20T10:00:00.000Z"
}

dnsRecordsarray

Every record to publish. The domain won't verify until they're all live.

Returns 409 Conflict if the domain is already registered.