create_webhook
Create a webhook endpoint that receives job events such as job.completed and job.failed at an HTTPS URL. Use it to be notified instead of polling get_verification or get_batch. Returns the signing secret once (field secret); store it, it is never shown again. The number of active endpoints is capped by the plan. Use update_webhook to change an endpoint and list_webhooks to see them. Requires the webhooks:create scope.
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>",
"events": "<events>"
},
"name": "create_webhook"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Target URL that receives event notifications. | |
| events | Yes | Event type strings to subscribe to (e.g. job.completed, job.failed). | |
| description | No | Optional human-readable description of the endpoint. |