API ReferenceSession Webhooks

Session hook: before execute

Sent before a tool or proxy call runs, when the session has a before_execute hook with a webhook handler. Composio waits for your answer, then runs the call, blocks it, or runs it with your changes.

Header Parameters

webhook-idstringRequired

Unique request id. Equals the payload id.

webhook-timestampstringRequired

Unix timestamp (seconds) of when the request was sent.

webhook-signaturestringRequired

Base64 HMAC-SHA256 signature made with your session webhook secret, formatted v1,<signature>, over ${webhook-id}.${webhook-timestamp}.${raw_body}.

Request Body

application/json

idstringRequired

Unique request id (msg_). Also sent as the webhook-id header.

timestampstringRequired

ISO 8601 timestamp of when the request was created.

Format: date-time
typeenumRequired
Possible values:
composio.session_hook.before_execute
metadataobjectRequired
dataobject | objectRequired

The call about to run. type says whether it is a tool call or a proxy call.

Response Body

application/json

Example Requests

POST/composio.session_hook.before_execute