voidmail_set_webhook
Sets a webhook URL to alert agents when new email arrives in an open-policy inbox with no owner key. Allowlist or owner-key inboxes must configure webhooks through the owner endpoint.
Instructions
Set a webhook URL to get notified when new email arrives on an open-policy inbox that has no owner key. On an allowlist inbox, or any inbox with an owner key, this agent-key tool is refused; the human owner must use POST /v1/agent-mail/owner/webhook with the owner key.
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": "voidmail_set_webhook"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | HTTPS webhook URL | |
| secret | No | Signing secret for the X-Voidmail-Signature-256 HMAC header, at least 32 characters (server-generated if omitted) |