---
title: "set_webhook_url"
method: POST
path: "/tools/set_webhook_url"
tags: ["Account"]
---

# set_webhook_url

`POST /tools/set_webhook_url`

## Request

- Base URL: `https://compabase.com/api/mcp`
- URL: `https://compabase.com/api/mcp/tools/set_webhook_url`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Configure, view, or remove a webhook endpoint for watchlist event notifications.
When configured, Compabase POSTs JSON to your URL when watched companies change.

**Does not consume quota.**

Available events:
- `watchlist.company_changed` – registry data or structure changed
- `watchlist.financials_updated` – new financial statement filed
- `watchlist.company_removed_from_registry` – company dissolved/removed

**Webhook signing:** Every delivery includes header `X-Compabase-Signature: t=<unix>,v1=<hex>`.
Verify by computing `HMAC-SHA256(raw_body, webhook_secret)` and comparing with `v1`.
The `webhook_secret` is returned on `get` and `set` actions.

**Example prompts:** "Set my webhook to https://my-app.com/hooks/compabase."
· "What webhook do I have configured?" · "Remove my webhook."

**Parameters:** `action` (required: `get`/`set`/`delete`), `url` (HTTPS, for set), `events` (array, optional).

## Response `200`

Webhook configuration

- object

---

[API](https://skmtc.dev/compabase/apis/compabase-mcp.md) · [All operations](https://skmtc.dev/compabase/apis/compabase-mcp/llms.txt) · [OpenAPI document](https://skmtc.dev/compabase/apis/compabase-mcp/revisions/43169ccbb0f7?raw)