WEBHOOK_URL_INVALID

The webhook URL is not valid: it must include a host (for example https://mydomain.com/webhook)

Category: Webhooks


HTTP status	`422` Unprocessable Content
Retry	After fixing the cause

When it happens

The webhook URL uses https:// but has no deliverable host, for example https:///path or https://.example.com. A value that is not a URL at all (not a url, https://) is rejected earlier, with 400 INVALID_JSON_FORMAT.

How to fix it

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/WEBHOOK_URL_INVALID",
  "title": "WEBHOOK_URL_INVALID",
  "detail": "The webhook URL is not valid: it must include a host (for example https://mydomain.com/webhook)",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "WEBHOOK_URL_INVALID",
    "message": "The webhook URL is not valid: it must include a host (for example https://mydomain.com/webhook)",
    "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 is not valid: it must include a host (for example https://mydomain.com/webhook)

La URL del webhook no es válida: debe incluir un host (por ejemplo https://midominio.com/webhook)

La URL del webhook no és vàlida: ha d'incloure un host (per exemple https://elmeudomini.com/webhook)

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

URL_TARGET_NOT_ALLOWED

The webhook URL points to an internal network address. Use an endpoint reachable from the internet.

WEBHOOK_ACTIVE_SUBSCRIPTION_LIMIT_REACHED

The account already has the maximum of ‹value› active webhook subscriptions. Deactivate or delete one before creating or reactivating another.

WEBHOOK_REACTIVATION_REQUIRES_LIVE_ENDPOINT

BeeL. paused this subscription. To reactivate it, the endpoint must first answer a test delivery successfully.