Verify a domain
Trigger an on-demand verification poll: Mailfully queries SES for the current DKIM and MAIL FROM status, runs the 72-hour verification state machine, persists…
POST
Trigger an on-demand verification poll: Mailfully queries SES for the current DKIM and MAIL FROM status, runs the 72-hour verification state machine, persists the result, and returns the updated domain (no DNS records). Overall verified requires both DKIM and MAIL FROM verified; DMARC is advisory and not part of the gate. Requires the send scope. Takes no request body.
Loading code example
Loading code example
Authorizations
Authorizationstringheaderrequired
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
idstringrequired
The domain id (`dom_…`).
Response
application/json
The domain with freshly evaluated statuses.
object"domain"requiredAllowed values:
"domain"idstringrequirednamestringrequiredregionstringrequiredServer-configured SES region.
mail_from_subdomainstringrequireddkim_tokensarray<string>requireddkim_status"not_started" | "pending" | "verified" | "failed"requiredAllowed values:
"not_started" | "pending" | "verified" | "failed"mail_from_status"not_started" | "pending" | "verified" | "failed"requiredAllowed values:
"not_started" | "pending" | "verified" | "failed"dmarc_status"not_started" | "pending" | "verified" | "failed"requiredAllowed values:
"not_started" | "pending" | "verified" | "failed"tracking_status"not_started" | "pending" | "verified" | "failed"requiredAllowed values:
"not_started" | "pending" | "verified" | "failed"tracking_enabledbooleanrequiredconfig_setstringrequiredstatus"pending" | "verified" | "failed" | "partially_verified"requiredAllowed values:
"pending" | "verified" | "failed" | "partially_verified"created_atstring<date-time>required