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.

1.8 KB
Raw Blame
---
title: Webhook Events
description: "Events delivered by Composio to your registered webhook endpoints"
---

{/* Auto-generated from openapi-webhooks.json. Edit the overview at api-overviews/webhook-events.mdx, not this file. */}

Webhook events delivered by the Composio platform to your registered endpoints.

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).

## Events

| Event | Description |
|-------|-------------|
| `composio.trigger.message` | [Trigger message](/reference/api-reference/webhook-events/composio_trigger_message) |
| `composio.connected_account.expired` | [Connection expired](/reference/api-reference/webhook-events/composio_connected_account_expired) |
| `composio.trigger.disabled` | [Trigger disabled](/reference/api-reference/webhook-events/composio_trigger_disabled) |

## Legacy payloads (deprecated)

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.

| Event | Version | Description |
|-------|---------|-------------|
| `composio.trigger.message` | V2 | [Trigger message (V2)](/reference/api-reference/webhook-events/composio_trigger_message_v2) |
| `composio.trigger.message` | V1 | [Trigger message (V1)](/reference/api-reference/webhook-events/composio_trigger_message_v1) |