set_webhook
Configure a webhook URL to receive inbound messages and call events for all agents or a specific agent; returns a secret for verifying signatures.
Instructions
Set a webhook URL to receive inbound messages and call events.
Pass agent_id to set a webhook for a specific agent (overrides project default). Omit agent_id to set the project-level webhook for all agents. The webhook secret is returned — use it to verify signatures.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>"
},
"name": "set_webhook"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The publicly accessible webhook URL (must be HTTPS in production) | |
| timeout | No | Webhook response timeout in seconds | |
| agent_id | No | Agent ID to set webhook for that agent only. Omit for project-level. | |
| context_limit | No | Number of recent messages to include as conversation context (0-50) |