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…

POSThttps://api.mailfully.com/v1/domains/{id}/verify

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"required
Allowed values: "domain"
idstringrequired
namestringrequired
regionstringrequired

Server-configured SES region.

mail_from_subdomainstringrequired
dkim_tokensarray<string>required
dkim_status"not_started" | "pending" | "verified" | "failed"required
Allowed values: "not_started" | "pending" | "verified" | "failed"
mail_from_status"not_started" | "pending" | "verified" | "failed"required
Allowed values: "not_started" | "pending" | "verified" | "failed"
dmarc_status"not_started" | "pending" | "verified" | "failed"required
Allowed values: "not_started" | "pending" | "verified" | "failed"
tracking_status"not_started" | "pending" | "verified" | "failed"required
Allowed values: "not_started" | "pending" | "verified" | "failed"
tracking_enabledbooleanrequired
config_setstringrequired
status"pending" | "verified" | "failed" | "partially_verified"required
Allowed values: "pending" | "verified" | "failed" | "partially_verified"
created_atstring<date-time>required