Skip to main content

webhook_url_not_allowed

The URL was refused, so the endpoint was not created or updated.

Status: 422

{
  "status": 422,
  "type": "webhook_url_not_allowed",
  "message": "The webhook URL must be a public http or https address",
  "request_id": "req_01J8K2P...",
  "doc_url": "https://docs.epostix.com/errors/webhook_url_not_allowed"
}

Why you got this​

  • The scheme is not http or https.
  • The host is localhost, a loopback address, or a private or link-local range.
  • The URL has no hostname at all.

We refuse these because a webhook URL is an address we will connect to on your behalf. Letting it point inside a network would turn the feature into a way to probe systems that are not meant to be reachable.

How to fix it​

Use a publicly resolvable address. For local development, put a tunnel in front of your machine and register the tunnel's public URL, or use a request-inspection service while you are working on the handler.

The check runs again at delivery time, so a hostname that resolves publicly today and to a private address later is still refused then. Point the endpoint at a host you control.

Is it safe to retry​

No, not with the same URL. Change it and try again.