@devries-cameron20 / composio Mirror · read-only / commits / 4bf90b024
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 21:00 UTC

docs: note webhook endpoints must be publicly accessible (#3328)

# Description Adds a one-line callout to the trigger-subscription docs page clarifying that user webhook endpoints must be publicly reachable. Composio's outbound webhook delivery runs on Cloudflare Workers, which use dynamic egress IPs — so IP allowlisting and private/VPN-only endpoints will silently drop webhook payloads (both `composio.trigger.message` and `composio.connected_account.expired`). The callout points readers to signature verification as the intended authentication mechanism instead. Placed on `subscribing-to-events.mdx` directly after the `POST /webhook_subscriptions` example, where users are actually setting their webhook URL. # How did I test this PR - Verified the claim by tracing webhook egress in `hermes`: cloud delivery flows through `defaultDeliveryService` → `sendComposioProxyRequest` → Cloudflare Workers external-proxy (`/workspace/hermes/wrangler/external-proxy/`); self-hosted goes through `directHttpDeliveryService`. Both `TRIGGER_MESSAGE_EVENT_TYPE` and `CONNECTION_EXPIRED_EVENT_TYPE` share this path (`apps/apollo/src/lib/events/handlers/webhook/handler.ts:86-90, 241-255`). No static-IP infrastructure exists for the Workers egress. - Confirmed the linked `/docs/webhook-verification` route already exists in the same file (line 30), so no new links were introduced. - Content-only MDX change (no TypeScript code blocks added), so twoslash type-checking is unaffected.

Alberto Schiabel committed May 7, 2026 at 14:39 UTC 4bf90b024da46c30f97f194153c41b753f792ef3

No changes.