Skip to navigation

write_webhook

Create, update and deactivate webhook endpoints

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
{"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>"}