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-timetypeenumRequired
Possible values:
composio.session_hook.before_executemetadataobjectRequired
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