Verify a domain

POST /domains/{id}/verify

Run a fresh DNS lookup against the domain’s expected records. If SPF, DKIM, and DMARC all resolve correctly, the domain transitions to verified and can be used as a sender. The MX record is checked but not required for outbound — it’s only needed for inbound replies.

Example

cURL

curl -X POST https://mail.3ava.com/api/domains/dom_a1b2.../verify \
  -H "Authorization: Bearer am_YOUR_KEY"

Response

{
  "id": "dom_a1b2...",
  "status": "verified",
  "dkim_verified": true,
  "spf_verified": true,
  "dmarc_verified": true,
  "mx_verified": false,
  "verified_at": "2026-04-22T22:35:00Z"
}

If verification fails, the response identifies which records are missing or incorrect:

{
  "status": "pending",
  "dkim_verified": true,
  "spf_verified": false,
  "spf_error": "TXT record found but missing 'include:_spf.3ava.com'",
  "dmarc_verified": true
}