Skip to content

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(triggers): drop "secret returned only once" claim — now retrievable anytime

Anshu Gargdc348d84af7f
diff --git a/docs/content/docs/setting-up-triggers/subscribing-to-events.mdx b/docs/content/docs/setting-up-triggers/subscribing-to-events.mdx
index f0cbeb38e..0df7523c0 100644
--- a/docs/content/docs/setting-up-triggers/subscribing-to-events.mdx
+++ b/docs/content/docs/setting-up-triggers/subscribing-to-events.mdx
@@ -27,7 +27,7 @@ curl -X POST https://backend.composio.dev/api/v3.1/webhook_subscriptions \
```
<Callout type="warn">
-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.
+The response includes a `secret` for [verifying webhook signatures](/docs/webhook-verification). Store it securely.
</Callout>
### Handling events
diff --git a/docs/content/docs/webhook-verification.mdx b/docs/content/docs/webhook-verification.mdx
index fe754f9f8..43d413480 100644
--- a/docs/content/docs/webhook-verification.mdx
+++ b/docs/content/docs/webhook-verification.mdx
@@ -15,7 +15,7 @@ Composio signs every webhook request. Always verify signatures in production to
The SDK handles signature verification, payload parsing, and version detection (V1, V2, V3).
<Callout>
-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`.
+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.
</Callout>
<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
@@ -65,7 +65,7 @@ An optional `tolerance` parameter (default: `300` seconds) controls how old a we
If you are not using the Composio SDK and want to verify signatures manually.
<Callout>
-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`.
+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.
</Callout>
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: