API ReferenceWebhook Events

Trigger disabled

Fired when Composio automatically disables a trigger (for example, auth expired or the webhook subscription can no longer be refreshed). Not fired when you disable the trigger or its connected account yourself.

Header Parameters

webhook-idstringRequired

Unique message ID, stable across delivery retries. Use it as an idempotency key.

webhook-timestampstringRequired

Unix timestamp (seconds) of this delivery attempt.

webhook-signaturestringRequired

Base64 HMAC-SHA256 signature, formatted v1,<signature>, over ${webhook-id}.${webhook-timestamp}.${raw_body}.

x-composio-webhook-versionstringRequired

Payload version for this subscription (for example V3).

x-composio-delivery-attemptstringRequired

Attempt number for this delivery, starting at 1 and incrementing on each retry. The payload and webhook-id are identical across attempts, so use webhook-id for idempotency rather than this value.

Request Body

application/json

idstringRequired

Unique event id (msg_). Also sent as the webhook-id header and stable across delivery retries — use it for idempotency.

timestampstringRequired

ISO 8601 timestamp of when the event was created.

Format: date-time
typeenumRequired
Possible values:
composio.trigger.disabled
dataobjectRequired
metadataobjectRequired

Response Body

Example Requests

POST/composio.trigger.disabled