Create webhook
tailscale_create_webhookCreate a Tailscale webhook to deliver selected events to an HTTPS endpoint, optionally formatted for Slack, Mattermost, Google Chat, or Discord. Save the returned signing secret immediately.
Instructions
Create a new webhook. The response includes the webhook's signing secret -- this is the only opportunity to capture it; save it immediately. Set providerType when the endpoint is a Slack, Mattermost, Google Chat or Discord incoming-webhook URL, so the events arrive in the format that provider renders.
SECURITY: the response body contains the secret verbatim. MCP clients commonly persist tool responses to logs and conversation transcripts; treat this response as sensitive.
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": {
"endpointUrl": "<endpointUrl>",
"subscriptions": "<subscriptions>"
},
"name": "tailscale_create_webhook"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| endpointUrl | Yes | The HTTPS URL to send webhook events to | |
| providerType | No | Format deliveries for a chat provider's incoming-webhook URL. Omit for raw Tailscale JSON -- the default, and what a custom receiver verifying signatures wants. Set once: it cannot be changed after creation. | |
| subscriptions | Yes | Event types to subscribe to (at least one). 'categoryTailnetManagement' and 'categoryDeviceMisconfigurations' subscribe to a whole category, including events Tailscale adds to it later. |