EMAIL_DOMAIN_RESERVED
That domain is reserved and cannot be used to send emails.
Category: Email delivery
| HTTP status | 422 Unprocessable Content |
| Retry | No |
When it happens
The domain, or a domain it is a subdomain of, is BeeL.'s own or a public mailbox provider (Gmail, Outlook, Yahoo, iCloud and the like). Mail cannot be sent in your name from a domain you do not control.
How to fix it
Register a domain your business owns.
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.
Example response
When this error occurs, the API answers 422 Unprocessable Content with a JSON body of this shape:
{
"type": "https://docs.beel.es/errors/EMAIL_DOMAIN_RESERVED",
"title": "EMAIL_DOMAIN_RESERVED",
"detail": "That domain is reserved and cannot be used to send emails.",
"instance": "/v1/<resource>",
"errors": [],
"success": false,
"error": {
"code": "EMAIL_DOMAIN_RESERVED",
"message": "That domain is reserved and cannot be used to send emails.",
"details": {}
},
"meta": {
"timestamp": "2026-05-21T10:00:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}The type URI is stable and always resolves to this page.
Message
Send the request with Accept-Language: <es|en|ca> to receive the message in your preferred language.
Other errors in this category
EMAIL_DOMAIN_INVALID
The domain is not valid. Provide a full domain name, such as invoices.example.com.
EMAIL_DOMAIN_LIMIT_REACHED
You have reached the maximum number of email domains for your account (‹value›).
EMAIL_DOMAIN_NOT_FOUND
No email domain with that id belongs to your account.
EMAIL_DOMAIN_NOT_READY
The domain is still being registered. Try again in a few seconds.
EMAIL_DOMAIN_UNAVAILABLE
That domain cannot be registered: it is already in use.