API ReferenceSession Webhooks

Session hook: after execute

Sent after a tool or proxy call runs, when the session has an after_execute hook with a webhook handler. Composio waits for your answer before the agent sees the result, and can withhold it or pass on 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.after_execute
metadataobjectRequired
dataobject | objectRequired

The call that just ran and what it returned. type says whether it is a tool call or a proxy call; the result is in tool_response or http_response.

Response Body

application/json

Example Requests

POST/composio.session_hook.after_execute