Verify a domain's DNS
POST/v1/domains/{id}/verify
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
| Name | In | Description |
|---|---|---|
| idrequired | path |
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.
| Field | Type | Description |
|---|---|---|
| object | "domain" | |
| id | string | |
| domain | string | |
| status | string | One of pending, verified, failed. |
| verified_at | timestamp | |
| receiving | boolean | True 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_at | timestamp | |
| created_at | timestamp | |
| records | array of DNSRecord |
Errors
| Status | Codes |
|---|---|
| 401 | authentication_required, invalid_api_key |
| 403 | insufficient_scope, domain_not_verified, recipient_suppressed, sending_paused, mfa_required |
| 404 | not_found, product_not_offered |
Also in Domains
- GET /v1/domains — List sending domains
- POST /v1/domains — Add a sending domain
- DELETE /v1/domains/{id} — Remove a sending domain