Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
docs: note that webhook endpoints must be publicly accessible
Composio's outbound webhook delivery uses Cloudflare Workers, which have dynamic egress IPs and cannot be allowlisted. Add a callout on the trigger-subscription page directing users to signature verification instead of IP-based authentication. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com> Co-authored-by: uday <uday@composio.dev>
Zen Agent committed
May 2, 2026 at 09:53 UTC
b390c9b9ba3c1286af39f845c9805d365e34863f
1 file changed
+4
docs/content/docs/setting-up-triggers/subscribing-to-events.mdx
+4
@@ -26,6 +26,10 @@ curl -X POST https://backend.composio.dev/api/v3.1/webhook_subscriptions \
26
}'
27
```
28
29
+<Callout>
30
+Your webhook endpoint must be publicly accessible — Composio's outbound IPs are dynamic, so IP allowlisting and private/VPN-only endpoints will not work. Use [signature verification](/docs/webhook-verification) to authenticate payloads instead.
31
+</Callout>
32
+
33
<Callout type="warn">
34
The response includes a `secret` for [verifying webhook signatures](/docs/webhook-verification). This is only returned at creation time or when you [rotate the secret](/reference/api-reference/webhooks/postWebhookSubscriptionsByIdRotateSecret). Store it securely.
35
</Callout>