Verify a domain

Trigger a DNS verification pass for a sending domain with the wemail API and read back which of the SPF, DKIM and DMARC records are in place.

Checks the published DNS records live and activates the domain when they match. Call it after DNS propagation; it is safe to call repeatedly.

PUT /v3/domains/{name}/verify

DKIM is the gate: the domain flips to verified as soon as the DKIM records check out. SPF, DMARC and the tracking CNAME are checked and reported per record (dns_records[].ok) but never block verification — publish them anyway for deliverability. A verified domain is not demoted by a failed re-check.

Responses

Code examples

curl -X PUT https://api.wemail.io/v3/domains/{name}/verify \
  -H "Authorization: Bearer afn_live_…"

const res = await fetch("https://api.wemail.io/v3/domains/{name}/verify", {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${process.env.WEMAIL_API_KEY}`,
  },
});
const data = await res.json();

import os, requests

r = requests.put(
    "https://api.wemail.io/v3/domains/{name}/verify",
    headers={"Authorization": f"Bearer {os.environ['WEMAIL_API_KEY']}"},
)
data = r.json()