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: fix webhook secret instructions to reflect new subscriptions API
Sushmithamallesh4f83f4c2b64e
diff --git a/docs/content/docs/setting-up-triggers/subscribing-to-events.mdx b/docs/content/docs/setting-up-triggers/subscribing-to-events.mdxindex cfd4ebc4f..88ec6dfa9 100644--- a/docs/content/docs/setting-up-triggers/subscribing-to-events.mdx+++ b/docs/content/docs/setting-up-triggers/subscribing-to-events.mdx@@ -25,6 +25,10 @@ curl -X POST https://backend.composio.dev/api/v3/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/rotate-webhook-subscription-secret). Store it securely.+</Callout>+### Handling eventsAll events arrive at the same endpoint. Route on the `type` field to handle each event type:diff --git a/docs/content/docs/webhook-verification.mdx b/docs/content/docs/webhook-verification.mdxindex a8066c432..485172701 100644--- a/docs/content/docs/webhook-verification.mdx+++ b/docs/content/docs/webhook-verification.mdx@@ -11,7 +11,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>-Get your webhook secret from [Project Settings > Webhook](https://platform.composio.dev?next_page=/settings/webhook) and store it as `COMPOSIO_WEBHOOK_SECRET`.+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`.</Callout><Tabs groupId="language" items={['Python', 'TypeScript']} persist>@@ -61,7 +61,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>-Get your webhook secret from [Project Settings > Webhook](https://platform.composio.dev?next_page=/settings/webhook) and store it as `COMPOSIO_WEBHOOK_SECRET`.+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`.</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: