WEBHOOK_URL_UNSAFE - Blujay API

HTTP status	Retryable
`400`	No

What happened

The URL points to a host Blujay will not deliver to, such as localhost or a private or internal IP address.

How to fix it

Use a publicly reachable HTTPS endpoint. For local testing, use a tunnel that gives you a public HTTPS URL.

Example response

An illustrative example. The message wording and the contents of details vary; branch on error.code.

{
  "status": "error",
  "error": {
    "code": "WEBHOOK_URL_UNSAFE",
    "message": "Webhook URL not allowed",
    "type": "validation",
    "http_status": 400,
    "retryable": false,
    "doc_url": "https://docs.blujay.io/errors/webhook-url-unsafe",
    "details": []
  },
  "trace_id": "trc_8f2a1c0e4b7d",
  "timestamp": "2026-10-14T17:30:48.000Z"
}

Still stuck?

Email support@blujay.io with the trace_id from the error response. See Errors for the response format.