Skip to main content

Domains

GET|POST /v0/domains · GET|PATCH|DELETE /v0/domains/:id (project twins too).

Setup

The response includes every DNS record to publish: ownership TXT, MX, SPF, DKIM and DMARC (plus wildcard MX when subdomains_enabled). GET …/:id/zone-file renders them as BIND text; GET …/:id/setup-link returns a console setup URL.

Verify

POST …/:id/verify checks the ownership TXT over DNS-over-HTTPS in real time. Missing records → PENDING (dns_records_missing); wrong values → dns_records_invalid; transient DNS trouble → retryable ses_* reasons. First success flips to VERIFIED and fires domain.verified. Enabling subdomains_enabled later returns the domain to PENDING until the wildcard MX exists. feedback_enabled routes bounces/complaints back to your inboxes; tracking_enabled is required for open tracking on that domain.