EMAIL_DOMAIN_INVALID
The domain is not valid. Provide a full domain name, such as invoices.example.com.
Category: Email delivery
| HTTP status | 422 Unprocessable Content |
| Retry | After fixing the cause |
When it happens
The value is not a full domain name: it needs at least two labels, each up to 63 characters, a non-numeric top-level domain and no more than 253 characters in all.
How to fix it
Send the bare domain, for example mail.example.com, without @, scheme or path.
Retry
Not as is: the same request fails the same way. Fix the cause described above, then send the request again, under a new Idempotency-Key if the body changed.
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_INVALID",
"title": "EMAIL_DOMAIN_INVALID",
"detail": "The domain is not valid. Provide a full domain name, such as invoices.example.com.",
"instance": "/v1/<resource>",
"errors": [],
"success": false,
"error": {
"code": "EMAIL_DOMAIN_INVALID",
"message": "The domain is not valid. Provide a full domain name, such as invoices.example.com.",
"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_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_RESERVED
That domain is reserved and cannot be used to send emails.
EMAIL_DOMAIN_UNAVAILABLE
That domain cannot be registered: it is already in use.