set_webhook_url

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).