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 API reference links to use correct slugs
The links used human-readable slugs (create-webhook-subscription, rotate-webhook-subscription-secret) but the OpenAPI-generated pages use operationId slugs (postWebhookSubscriptions, etc). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sushmithamallesh committed
Feb 17, 2026 at 19:58 UTC
723a1fb3de28627cb8d35d1494061cc46a66f564
2 files changed
+3
-3
docs/content/docs/setting-up-triggers/subscribing-to-events.mdx
+1
-1
@@ -26,7 +26,7 @@ curl -X POST https://backend.composio.dev/api/v3/webhook_subscriptions \
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.
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/postWebhookSubscriptionsByIdRotateSecret). Store it securely.
30
</Callout>
31
32
### Handling events
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
-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`.
14
+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`.
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
-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`.
64
+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`.
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: