> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.solvimon.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.solvimon.com/_mcp/server.

# write_webhook

**Live server:** test server (`test.mcp.solvimon.com`) only.

Creates, updates and deactivates webhook endpoints.

**Actions:** `create`, `update`, `deactivate`

* Event names must match exactly (`INVOICE.PAID`), without wildcards. Unknown names are refused with the list of real ones.
* When `included_actions` is set, `excluded_actions` is ignored, and the result warns you.
* The authentication type (`API_KEY`, `PASSWORD` or `NONE`) is fixed at creation. To change it, create a new webhook and deactivate the old one.
* Secrets are never echoed back. `update` with `active: true` re-enables a webhook that was disabled after failures. Deleting a webhook and rolling its signing secret are done in Desk.

**`Create a webhook`**

```json Create a webhook
{"action": "create", "name": "Invoice events", "reference": "billing-events", "url": "https://api.example.com/webhooks/solvimon", "included_actions": ["INVOICE.STATUS_TO_FINAL", "INVOICE.PAID"], "authentication_type": "API_KEY", "api_header_field": "X-Webhook-Token", "api_key": "<secret>"}
```