ErrorsAll codes
URL_TARGET_NOT_ALLOWED
The webhook URL points to an internal network address. Use an endpoint reachable from the internet.
Category: Webhooks
Example response
When this error occurs, the API returns a JSON response with the following shape:
{
"type": "https://docs.beel.es/errors/URL_TARGET_NOT_ALLOWED",
"title": "URL_TARGET_NOT_ALLOWED",
"detail": "The webhook URL points to an internal network address. Use an endpoint reachable from the internet.",
"instance": "/v1/<resource>",
"errors": [],
"success": false,
"error": {
"code": "URL_TARGET_NOT_ALLOWED",
"message": "The webhook URL points to an internal network address. Use an endpoint reachable from the internet.",
"details": {}
},
"meta": {
"timestamp": "2026-05-21T10:00:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}The type URI is stable and always resolves to this page.
Message
The webhook URL points to an internal network address. Use an endpoint reachable from the internet.
La URL del webhook apunta a una dirección de red interna. Usa un endpoint accesible desde internet.
La URL del webhook apunta a una adreça de xarxa interna. Fes servir un endpoint accessible des d''internet.
Send the request with Accept-Language: <es|en|ca> to receive the message in your preferred language.
Other errors in this category
DELIVERY_LOG_NOT_FOUND
Webhook delivery log not found
URL_MUST_BE_HTTPS
The webhook URL must use HTTPS
WEBHOOK_REACTIVATION_REQUIRES_LIVE_ENDPOINT
BeeL paused this subscription. To reactivate it, the endpoint must first answer a test delivery successfully.
WEBHOOK_SUBSCRIPTION_NOT_FOUND
Webhook subscription not found
WEBHOOK_URL_INVALID
The webhook URL is not valid: it must include a host (for example https://mydomain.com/webhook)