Questions · Published 2026-09-29 · Updated 2026-09-29 · AgentiSend
What does dns_unreachable mean?
dns_unreachable means the send or the check was refused with that code. The catalogue message is quoted below, retryable is true, and the fix names the next call.
dns_unreachable means the request was refused with this code. The error catalogue message is "The DNS lookup did not complete. This is not a problem with the records you published." The fix is "Wait; checks continue on their own. Retry this call after the seconds given in Retry-After." retryable is true.
The fix, and the call it names
The fix says to retry this call after the seconds in Retry-After. When the call was POST /domains/{id}/verify, that is the call to send again. retryable is true, and the catalogue wait is the retry_after_seconds on the error. The message says the lookup did not complete, so the records you published are not what failed. Checks also continue on their own. GET /domains/{id} is the sheet to read after the wait. POST /domains is how the domain was registered.
curl -sS -X POST https://api.agentisend.com/domains/9c8f8f0e-3d1a-4d3f-9a1e-2b7c1a0f5e42/verify \
-H "Authorization: Bearer $AGENTISEND_API_KEY" \
-H "Idempotency-Key: $(uuidgen)"200
{
"click_tracking": false,
"created_at": "2026-09-04T09:14:00.000Z",
"dkim_selector": "example",
"id": "9c8f8f0e-3d1a-4d3f-9a1e-2b7c1a0f5e42",
"name": "example",
"open_tracking": false,
"provider_hints": {
"cloudflare": "example",
"godaddy": "example",
"namecheap": "example",
"route53": "example"
},
"recent_events": [],
"records": [],
"region": "us",
"return_path_subdomain": "example",
"status": "pending",
"tls_mode": "opportunistic",
"tracking_issues": [],
"tracking_subdomain": "example",
"verified_at": "2026-09-04T09:14:00.000Z",
"warnings": [],
"zone": "example"
}Next
Written by the AgentiSend team.