Sign in

v4

OpenAPI 3.0.0MIT2026-07-311554531.6 MB
Domains

Verify a domain

Performs a live DNS lookup to refresh the MX record status of the domain and updates the verification status accordingly. Returns the latest domain configuration.

post/v1/domains/{domain}/verify

Path parameters

domainstring required

Response

OK

_idstring required
namestring required
status'pending' | 'verified' required
mxRecordConfiguredboolean required
dnsProviderstring
_environmentIdstring required
_organizationIdstring required
createdAtstring required
updatedAtstring required
dataobject

String key-value metadata (max 10 keys, 500 characters total when set via API).

Example response

{
  "expectedDnsRecords": [
    {
      "type": "MX",
      "name": "inbound",
      "content": "inbound-smtp.us-east-1.amazonaws.com",
      "ttl": "Auto",
      "priority": 10
    }
  ]
}