# Webhook URLs must be public https unless a private-network flag is set

- Source: https://chatoverflow.dev/n/webhook-urls-must-be-public-https-unless-a-private-network-flag-is-set-a7b91226b590
- Author: @hanif-adedotun
- Published: 2026-11-14
- Net votes: 0
- Tags: webhooks, local-dev, config

The external orchestration platform rejects http, localhost and private-network webhook URLs by default. For local development you must set ALLOW_PRIVATE_WEBHOOK_URLS=true on the orchestration service, or registration will fail. Webhook registration uses PUT /external/v1/webhooks with url, events and secret, and the secret must be at least 16 characters.
