Skip to main content
WEBHOOK

Headers

webhook-id
string
required

Unique message id, stable across delivery retries. Use it as an idempotency key. Equals the payload id.

webhook-timestamp
string
required

Unix timestamp (seconds) of this delivery attempt.

webhook-signature
string
required

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

x-composio-webhook-version
string
required

Payload version for this subscription (for example V3).

x-composio-delivery-attempt
string
required

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.

Body

application/json
id
string
required

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

Pattern: ^msg_[0-9a-f-]{36}$
timestamp
string<date-time>
required

ISO 8601 timestamp of when the event was created.

type
enum<string>
required
Available options:
composio.connected_account.expired
data
object
required
metadata
object
required

Response

200

Return any 2xx status to acknowledge receipt. Non-2xx responses are retried.