Skip to main content

domain_not_found

No domain with that name exists in the workspace the key belongs to. Nothing was sent and nothing was charged.

Status: 404

{
  "status": 404,
  "type": "domain_not_found",
  "message": "Domain not found",
  "request_id": "req_01J8K2P...",
  "doc_url": "https://docs.epostix.com/errors/domain_not_found"
}

Why you got this​

  • The from address uses a domain that was never added to this workspace.
  • The domain belongs to another workspace. That case returns 404 as well, so the response never confirms whether a domain exists somewhere else.
  • The host is close but not exact. mail.example.com and example.com are separate domains and are added separately.
  • You added the domain in one workspace and are calling with a key from another.

How to fix it​

List the domains in the workspace the key belongs to and compare the host in your from address character for character. Add the missing domain, then publish its DNS records and complete domain verification before your first send.

If the domain is already listed and the request still fails, the type changes to domain_not_verified: the domain exists but has not passed its DNS check yet.

Is it safe to retry​

No. The same from address returns the same 404 until the domain exists in this workspace. Correct the address or add the domain, then send a new request.

Reusing the Idempotency-Key afterwards is safe, because a rejected request was never stored.