Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
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.mdxindex 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 eventsdiff --git a/docs/content/docs/webhook-verification.mdx b/docs/content/docs/webhook-verification.mdxindex 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 toThe 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 weIf 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: