URL_NOT_ALLOWED

HTTP status: 422

What it means

A supplied URL was rejected by the egress guard (scheme or address not allowed).

Why it happens

• The URL points at a private, loopback or link-local address (SSRF protection), or an unsupported scheme. Webhook and asset URLs must resolve to public addresses.

How to fix it

• Use a publicly resolvable https URL — not localhost, not a private IP, not an internal hostname.

Example

Every non-2xx response uses the same envelope; path (when present) is the exact JSON path of the offending field, and requestId identifies the request in support conversations:

{
  "error": {
    "code": "URL_NOT_ALLOWED",
    "message": "URL (unknown) is not allowed. Only public http(s) URLs are accepted.",
    "docsUrl": "https://automotion.dev/docs/errors/url_not_allowed"
  },
  "requestId": "req_0123456789abcdef0123456789abcdef"
}

See the error index for the full catalog and the API overview for envelope semantics.