@devries-cameron20 / composio-1 / commits / 4f83f4c2b
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.

docs: fix webhook secret instructions to reflect new subscriptions API

The old docs pointed users to "Project Settings > Webhook" to get their secret, which is no longer accurate. The secret is only returned when creating a subscription or rotating it. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Sushmithamallesh committed Feb 13, 2026 at 18:03 UTC 4f83f4c2b64e356aec2ec5ed414abda506244fc9
2 files changed +6 -2
docs/content/docs/setting-up-triggers/subscribing-to-events.mdx
+4
@@ -25,6 +25,10 @@ curl -X POST https://backend.composio.dev/api/v3/webhook_subscriptions \
25 }'
26 ```
27
28 +<Callout type="warn">
29 +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/rotate-webhook-subscription-secret). Store it securely.
30 +</Callout>
31 +
32 ### Handling events
33
34 All events arrive at the same endpoint. Route on the `type` field to handle each event type:
docs/content/docs/webhook-verification.mdx
+2 -2
@@ -11,7 +11,7 @@ Composio signs every webhook request. Always verify signatures in production to
11 The SDK handles signature verification, payload parsing, and version detection (V1, V2, V3).
12
13 <Callout>
14 -Get your webhook secret from [Project Settings > Webhook](https://platform.composio.dev?next_page=/settings/webhook) and store it as `COMPOSIO_WEBHOOK_SECRET`.
14 +Your webhook secret is returned **only once**: when you [create a webhook subscription](/reference/api-reference/webhooks/create-webhook-subscription) or [rotate the secret](/reference/api-reference/webhooks/rotate-webhook-subscription-secret). If you didn't copy it at creation time, rotate it to get a new one. Store it securely as `COMPOSIO_WEBHOOK_SECRET`.
15 </Callout>
16
17 <Tabs groupId="language" items={['Python', 'TypeScript']} persist>
@@ -61,7 +61,7 @@ An optional `tolerance` parameter (default: `300` seconds) controls how old a we
61 If you are not using the Composio SDK and want to verify signatures manually.
62
63 <Callout>
64 -Get your webhook secret from [Project Settings > Webhook](https://platform.composio.dev?next_page=/settings/webhook) and store it as `COMPOSIO_WEBHOOK_SECRET`.
64 +Your webhook secret is returned **only once**: when you [create a webhook subscription](/reference/api-reference/webhooks/create-webhook-subscription) or [rotate the secret](/reference/api-reference/webhooks/rotate-webhook-subscription-secret). If you didn't copy it at creation time, rotate it to get a new one. Store it securely as `COMPOSIO_WEBHOOK_SECRET`.
65 </Callout>
66
67 Every webhook request includes three headers: `webhook-signature`, `webhook-id`, and `webhook-timestamp`. Use these along with the raw request body to verify the signature: