---
title: "Update a webhook"
method: PATCH
path: "/v2/oauth-clients/{clientId}/webhooks/{webhookId}"
tags: ["Deprecated: Platform / Webhooks"]
---

# Update a webhook

`PATCH /v2/oauth-clients/{clientId}/webhooks/{webhookId}`

<Warning>These endpoints are deprecated and will be removed in the future.</Warning>

## Path parameters

- `webhookId` string, required
- `clientId` string, required

## Headers

- `x-cal-secret-key` string, required

## Request body

- UpdateWebhookInputDto
  - `payloadTemplate` string — The template of the payload that will be sent to the subscriberUrl, check cal.com/docs/core-features/webhooks for more information
  - `active` boolean
  - `subscriberUrl` string
  - `triggers` string[]
  - `secret` string
  - `version` '2021-10-20' — The version of the webhook

## Response `200`

- OAuthClientWebhookOutputResponseDto
  - `status` 'success' | 'error', required
  - `data` OAuthClientWebhookOutputDto, required
    - `payloadTemplate` string, required — The template of the payload that will be sent to the subscriberUrl, check cal.com/docs/core-features/webhooks for more information
    - `triggers` string[], required
    - `oAuthClientId` string, required
    - `id` number, required
    - `subscriberUrl` string, required
    - `active` boolean, required
    - `secret` string

## Changes

- **2026-07-17** (v2) `16de9d3eb7b3` — 1 breaking, 1 info
  - removed the enum value `ROUTING_FORM_FALLBACK_HIT` of the request property `triggers/items/`
  - removed the `ROUTING_FORM_FALLBACK_HIT` enum value from the `data/triggers/items/` response property for the response status `200`
- **2026-03-10** (v2) `be4b1e3efe56` — 1 breaking
  - added the new path request parameter `clientId`
- **2026-03-05** (v2) `b08d7bb5d881` — 22 breaking, 21 warning
  - removed the enum value `AFTER_GUESTS_CAL_VIDEO_NO_SHOW` of the request property `triggers`
  - removed the enum value `AFTER_HOSTS_CAL_VIDEO_NO_SHOW` of the request property `triggers`
  - removed the enum value `BOOKING_CANCELLED` of the request property `triggers`
  - removed the enum value `BOOKING_CREATED` of the request property `triggers`
  - …39 more
- **2026-01-23** (v2) `80f2bde1c3fa` — 1 info
  - added the new `WRONG_ASSIGNMENT_REPORT` enum value to the request property `triggers`
- **2026-01-15** (v2) `946fc816b290` — 2 info
  - api tag `Deprecated: Platform / Webhooks` added
  - api tag `Platform / Webhooks` removed

[Full history](https://skmtc.dev/calcom/apis/cal-diy-api-v2/changes/v2/oauth-clients/:clientId/webhooks/:webhookId/patch.md)

---

[API](https://skmtc.dev/calcom/apis/cal-diy-api-v2.md) · [All operations](https://skmtc.dev/calcom/apis/cal-diy-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/calcom/cal-diy-api-v2/revisions/16de9d3eb7b3/schema)