Create Webhook
create_webhookCreate an incoming webhook for a room the account owns. The bound account must be Pro. Returns the secret trigger URL — treat it as a credential.
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": {
"invite_code": "<invite_code>",
"name": "<name>"
},
"name": "create_webhook"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| icon | No | A v3 room-icon catalog id, e.g. "bell". Call list_room_icons to discover the valid ids. | |
| name | Yes | Webhook name (shown to the owner). | |
| color | No | Hex color, e.g. "#e33122". | |
| sound | No | Canonical sound id, e.g. "ting". Omit for the room default. | |
| title | No | Optional push title used when the webhook fires. | |
| enabled | No | Whether the webhook is active. Defaults to true. | |
| message | No | Optional default push body (max 120 characters in private rooms, 160 in public rooms). | |
| invite_code | Yes | Room invite code. | |
| action_number | No | Quick-action slot whose label, sound, and acknowledgement preset fires use. Omit or pass null for an independent webhook with no Quick Ping preset. | |
| cooldown_seconds | No | Minimum seconds between fires. Defaults to 5. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | An incoming webhook. `webhook_url` embeds the secret — treat it as a credential. |