Skip to content

Errors and troubleshooting

Common status codes and setup failures.

01

HTTP status codes#

400 means invalid input or unverified resources; 401 means a missing or invalid key; 403 means the key's scope is too narrow for the endpoint (for example a pod key calling /v0/api-keys) or the plan doesn't include the feature; 404 means unknown resource; 409 commonly means DNS verification is not complete; 429 means a rate or plan cap; 502 means delivery failed temporarily and is safe to retry later.

02

No email arrives#

Check the recipient address matches the inbox exactly, and that the inbox's sender rules aren't blocking the sender (allowlist mode rejects unknown senders). On a custom domain, confirm the MX record from the domain setup is published and the domain shows VERIFIED; another MX record at the same name will split or divert mail.

03

Domain will not verify#

Confirm the exact botinbox-verify TXT value, wait for DNS propagation, and avoid publishing the record only at a proxied hostname.