EMAIL_DOMAIN_UNAVAILABLE

That domain cannot be registered: it is already in use.


HTTP status	`409` Conflict
Retry	No

When it happens

The domain is already registered, in this account or elsewhere. The answer is the same in every case, so it does not reveal who holds it.

How to fix it

Check the account's list with GET …/email-domains. If you have just deleted it, wait a few minutes and register it again; if it persists, contact support.

Retry

Do not retry. The outcome is final: sending the same request again gets the same answer.

Returned by

The operations where this code is most likely. The list is not exhaustive.

POST /v1/accounts/{account_id}/email-domains

Example response

When this error occurs, the API answers 409 Conflict with a JSON body of this shape:

{
  "type": "https://docs.beel.es/errors/EMAIL_DOMAIN_UNAVAILABLE",
  "title": "EMAIL_DOMAIN_UNAVAILABLE",
  "detail": "That domain cannot be registered: it is already in use.",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "EMAIL_DOMAIN_UNAVAILABLE",
    "message": "That domain cannot be registered: it is already in use.",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}