API Reference

Webhook Events

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

Configure your webhook subscriptions via the Webhook Subscriptions API, and verify signatures as described in Verifying signatures.

Events

EventDescription
composio.trigger.messageTrigger message
composio.connected_account.expiredConnection expired
composio.trigger.disabledTrigger 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. New integrations should use the current events above.

EventVersionDescription
composio.trigger.messageV2Trigger message (V2)
composio.trigger.messageV1Trigger message (V1)