# Create a domain

> Register a domain and get the DNS records to publish.

`POST https://inboundr.net/api/v1/domains`

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](/concepts/domains).

<ParamField body="domain" type="string" required>
  The domain name, e.g. `yourdomain.com`. Lowercased; must be a valid public
  domain.
</ParamField>

<ResponseExample>
```json 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"
}
```
</ResponseExample>

<ResponseField name="dnsRecords" type="array">
  Every record to publish. The domain won't verify until they're all live.
</ResponseField>

<Warning>
  Returns `409 Conflict` if the domain is already registered.
</Warning>