Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
| 1 | --- |
| 2 | title: Webhook Events |
| 3 | description: "Events delivered by Composio to your registered webhook endpoints" |
| 4 | --- |
| 5 | |
| 6 | {/* Auto-generated from openapi-webhooks.json. Edit the overview at api-overviews/webhook-events.mdx, not this file. */} |
| 7 | |
| 8 | Webhook events delivered by the Composio platform to your registered endpoints. |
| 9 | |
| 10 | Configure your webhook subscriptions via the [Webhook Subscriptions API](/reference/api-reference/webhook-subscriptions/postWebhookSubscriptions), and verify signatures as described in [Verifying signatures](/docs/setting-up-triggers/subscribing-to-events#verifying-signatures). |
| 11 | |
| 12 | ## Events |
| 13 | |
| 14 | | Event | Description | |
| 15 | |-------|-------------| |
| 16 | | `composio.trigger.message` | [Trigger message](/reference/api-reference/webhook-events/composio_trigger_message) | |
| 17 | | `composio.connected_account.expired` | [Connection expired](/reference/api-reference/webhook-events/composio_connected_account_expired) | |
| 18 | | `composio.connected_account.activated` | [Connection activated](/reference/api-reference/webhook-events/composio_connected_account_activated) | |
| 19 | | `composio.trigger.disabled` | [Trigger disabled](/reference/api-reference/webhook-events/composio_trigger_disabled) | |
| 20 | |
| 21 | ## Legacy payloads (deprecated) |
| 22 | |
| 23 | Older subscriptions may still receive these payload formats. The event type is unchanged — only the payload shape differs, selected by the subscription's version. You can upgrade an existing subscription at any time by updating its `version` — see [Update a webhook subscription](/reference/api-reference/webhook-subscriptions/patchWebhookSubscriptionsById). New integrations should use the current events above. |
| 24 | |
| 25 | | Event | Version | Description | |
| 26 | |-------|---------|-------------| |
| 27 | | `composio.trigger.message` | V2 | [Trigger message (V2)](/reference/api-reference/webhook-events/composio_trigger_message_v2) | |
| 28 | | `composio.trigger.message` | V1 | [Trigger message (V1)](/reference/api-reference/webhook-events/composio_trigger_message_v1) | |