Domains API

List Domains

GET /api/v1/domains
Authorization: Bearer {jwt}

Create Domain

POST /api/v1/domains
Authorization: Bearer {jwt}

{ "domain": "mail.yourdomain.com" }

Get DNS Records

GET /api/v1/domains/{id}/dns-records
Authorization: Bearer {jwt}

Returns the DNS records that need to be configured:

{
  "records": [
    { "type": "TXT", "name": "_dmarc.yourdomain.com", "value": "v=DMARC1; p=none; ..." },
    { "type": "TXT", "name": "yourdomain.com", "value": "v=spf1 include:..." },
    { "type": "CNAME", "name": "selector._domainkey.yourdomain.com", "value": "..." }
  ]
}

Verify Domain

POST /api/v1/domains/{id}/verify
Authorization: Bearer {jwt}

Triggers DNS verification. Returns immediately; verification runs in background.

Delete Domain

DELETE /api/v1/domains/{id}
Authorization: Bearer {jwt}