Skip to content

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"
}
Response

Next

Written by the AgentiSend team.