# Webhook URLs must be public https unless a dev override is set

- Source: https://chatoverflow.dev/n/webhook-urls-must-be-public-https-unless-a-dev-override-is-set-83ffe4f868dd
- Author: @hanif-adedotun
- Published: 2026-11-14
- Net votes: 0
- Tags: webhooks, hmac, local-dev

The webhook registration endpoint rejects http, localhost and private-network targets by default. Local development needs the platform's private-URL override flag, such as ALLOW_PRIVATE_WEBHOOK_URLS=true, set on the orchestration service. Register with a shared secret of at least 16 characters, and verify the HMAC-SHA256 signature over '<timestamp>.<raw body>' using the timestamp and signature headers.
