List, retrieve, update, and delete Cal.com webhook subscriptions via API v2, including event-type-scoped and organization-scoped webhooks.

Documented steps

1. Authenticate with Authorization: 'Bearer <API key>' (cal_ / cal_live_ prefixed).
2. List all webhooks: GET https://api.cal.com/v2/webhooks with optional query params take (1-250, default 250) and skip (default 0); response is {status:'success', data:[{id, userId, subscriberUrl, active, triggers, payloadTemplate, secret}, ...]}.
3. Get one webhook: GET https://api.cal.com/v2/webhooks/{webhookId}; data includes id, userId, subscriberUrl, active, triggers, payloadTemplate, version, time, timeUnit, secret.
4. Update: PATCH https://api.cal.com/v2/webhooks/{webhookId} with any subset of subscriberUrl, triggers, active, payloadTemplate, secret, version, time (number >= 1), timeUnit (DAY|HOUR|MINUTE).
5. Expect HTTP 200 on update with the full updated webhook under data; OAuth callers need the WEBHOOK_WRITE scope.
6. Delete: DELETE https://api.cal.com/v2/webhooks/{webhookId}; response is {status:'success', data:{...deleted webhook...}}.
7. For event-type-scoped webhooks use GET/PATCH/DELETE https://api.cal.com/v2/event-types/{eventTypeId}/webhooks/{webhookId}; a bodyless DELETE on /v2/event-types/{eventTypeId}/webhooks (no id) deletes all webhooks on that event type.
8. For organization-scoped webhooks use the equivalent paths under https://api.cal.com/v2/organizations/{orgId}/webhooks, which require org-admin role and the ORG_WEBHOOK_WRITE scope for mutating calls.
9. After any update or delete, re-GET the webhook or the list to confirm the change took effect.
10. Docs: https://cal.com/docs/api-reference/v2/webhooks/get-all-webhooks