Register a webhook
create_webhookRegister a public HTTPS endpoint to receive subscribed event deliveries and obtain its signing secret once, enabling receivers to verify signatures and distinguish real deliveries.
Instructions
Purpose: register an endpoint to receive event deliveries. NOT for: retrieving a secret you lost. Store the signing secret when you get it. Returns: the endpoint and its signing secret, ONCE. Verifying that signature is the only way a receiver can tell a real delivery from anything else.
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": "create_webhook"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | An https URL on a public host to deliver to. | |
| events | No | Event types to subscribe to, spelled as in the event catalogue. Defaults to ["*"] — everything. A name that is not a real event type is refused. | |
| svix_compat | No | Also sign each delivery with svix-id, svix-timestamp and svix-signature, so a verifier written for those headers keeps working. | |
| payload_format | No | native is the default envelope. resend is {type, created_at, data} with data.email_id, data.to and data.bounce.type, subType and diagnosticCode. | |
| idempotency_key | No | Your own key for this action. Retrying with the same key returns the first result instead of doing it twice — send one whenever a retry could double the effect. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Identifier. | |
| url | No | ||
| error | No | Present instead of the fields above when the call was refused: code, message, fix, docs_url, retryable and, when waiting helps, retry_after_seconds. | |
| events | No | ||
| secret | No | The signing secret, shown once. | |
| disabled | No |