WoyraDocs
Get an API key

Verify a domain's DNS

POST/v1/domains/{id}/verify

Domains · Requires an API key

Re-checks the domain's DNS and records the outcome. Safe to call repeatedly: a customer who publishes DNS and checks too early can simply check again, without recreating the domain and being issued a new key.

Each record reports its own result, because a missing DKIM record and a duplicate SPF record need completely different fixes.

A domain that was verified and whose DNS has since been removed returns to failed, and sending from it stops.

Parameters

NameInDescription
idrequiredpath

Example

curl -X POST https://api.woyra.io/v1/domains/email_01J.../verify \
  -H "Authorization: Bearer $WOYRA_KEY"

Response

200 The verification result, per record.

FieldTypeDescription
object"domain"
idstring
domainstring
statusstring
One of pending, verified, failed.
verified_attimestamp
receivingbooleanTrue once the domain is verified and its MX record points at Woyra: every address on it then receives, and each message is stored under /v1/emails/inbound and sent as email.received.
receiving_verified_attimestamp
created_attimestamp
recordsarray of DNSRecord

Errors

StatusCodes
401authentication_required, invalid_api_key
403insufficient_scope, domain_not_verified, recipient_suppressed, sending_paused, mfa_required
404not_found, product_not_offered

Also in Domains