@devries-cameron20 / composio Mirror · read-only / commits / dc348d84a
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(triggers): drop "secret returned only once" claim — now retrievable anytime

The webhook subscription secret is no longer one-shot at creation. Customers can fetch it later from the subscription endpoint or rotate it. Update the three places that still made the old claim: - subscribing-to-events.mdx: remove the middle sentence from the warn callout. Result: "The response includes a `secret` for verifying webhook signatures. Store it securely." - webhook-verification.mdx (×2): SDK and manual sections both had "Your webhook secret is returned only once..." callouts. Replace with a short note pointing at GET /webhook_subscriptions/{id} for fetching and the rotate endpoint for rotation, with the same "store as COMPOSIO_WEBHOOK_SECRET" guidance. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Anshu Garg committed May 7, 2026 at 19:08 UTC dc348d84af7f09ffbbd5877caec68b6cef81b896
2 files changed +3 -3
docs/content/docs/setting-up-triggers/subscribing-to-events.mdx
+1 -1
@@ -27,7 +27,7 @@ curl -X POST https://backend.composio.dev/api/v3.1/webhook_subscriptions \
27 ```
28
29 <Callout type="warn">
30 -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.
30 +The response includes a `secret` for [verifying webhook signatures](/docs/webhook-verification). Store it securely.
31 </Callout>
32
33 ### Handling events
docs/content/docs/webhook-verification.mdx
+2 -2
@@ -15,7 +15,7 @@ Composio signs every webhook request. Always verify signatures in production to
15 The SDK handles signature verification, payload parsing, and version detection (V1, V2, V3).
16
17 <Callout>
18 -Your webhook secret is returned **only once**: when you [create a webhook subscription](/reference/api-reference/webhooks/postWebhookSubscriptions) or [rotate the secret](/reference/api-reference/webhooks/postWebhookSubscriptionsByIdRotateSecret). If you didn't copy it at creation time, rotate it to get a new one. Store it securely as `COMPOSIO_WEBHOOK_SECRET`.
18 +Store the webhook secret securely as `COMPOSIO_WEBHOOK_SECRET`. You can fetch it from the [webhook subscription](/reference/api-reference/webhooks/getWebhookSubscriptionsById) at any time or [rotate it](/reference/api-reference/webhooks/postWebhookSubscriptionsByIdRotateSecret) if it leaks.
19 </Callout>
20
21 <Tabs groupId="language" items={['Python', 'TypeScript']} persist>
@@ -65,7 +65,7 @@ An optional `tolerance` parameter (default: `300` seconds) controls how old a we
65 If you are not using the Composio SDK and want to verify signatures manually.
66
67 <Callout>
68 -Your webhook secret is returned **only once**: when you [create a webhook subscription](/reference/api-reference/webhooks/postWebhookSubscriptions) or [rotate the secret](/reference/api-reference/webhooks/postWebhookSubscriptionsByIdRotateSecret). If you didn't copy it at creation time, rotate it to get a new one. Store it securely as `COMPOSIO_WEBHOOK_SECRET`.
68 +Store the webhook secret securely as `COMPOSIO_WEBHOOK_SECRET`. You can fetch it from the [webhook subscription](/reference/api-reference/webhooks/getWebhookSubscriptionsById) at any time or [rotate it](/reference/api-reference/webhooks/postWebhookSubscriptionsByIdRotateSecret) if it leaks.
69 </Callout>
70
71 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: