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

# Update a webhook

`PATCH /v2/webhooks/{webhookId}`

## Path parameters

- `webhookId` string, required

## Headers

- `Authorization` 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` 'BOOKING_CREATED' | 'BOOKING_PAYMENT_INITIATED' | 'BOOKING_PAID' | 'BOOKING_RESCHEDULED' | 'BOOKING_REQUESTED' | 'BOOKING_CANCELLED' | 'BOOKING_REJECTED' | 'BOOKING_NO_SHOW_UPDATED' | 'FORM_SUBMITTED' | 'MEETING_ENDED' | 'MEETING_STARTED' | 'RECORDING_READY' | 'INSTANT_MEETING' | 'RECORDING_TRANSCRIPTION_GENERATED' | 'OOO_CREATED' | 'AFTER_HOSTS_CAL_VIDEO_NO_SHOW' | 'AFTER_GUESTS_CAL_VIDEO_NO_SHOW' | 'FORM_SUBMITTED_NO_EVENT' | 'DELEGATION_CREDENTIAL_ERROR'
  - `secret` string
  - `version` '2021-10-20' — The version of the webhook

## Response `200`

- UserWebhookOutputResponseDto
  - `status` 'success' | 'error', required
  - `data` UserWebhookOutputDto, 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
    - `userId` number, required
    - `id` number, required
    - `triggers` object[], required
    - `subscriberUrl` string, required
    - `active` boolean, required
    - `secret` string

## Changes

- **2026-01-06** (v2) `2ecd46907a81` — 1 info
  - added the new optional request property `version`
- **2025-11-17** (v2) `75e2f2eeed90` — 1 info
  - added the new `DELEGATION_CREDENTIAL_ERROR` enum value to the request property `triggers`
- **2025-09-26** (v2) `daa3e48bc03a` — 3 breaking, 1 warning, 38 info
  - request property `triggers` was restricted to a list of enum values
  - the `triggers` request property type/format changed from `array`/`` to `string`/``
  - the `data/triggers/items/` response's property type/format changed from `string`/`` to `object`/`` for status `200`
  - removed the request property `version`
  - …38 more

[Change history](https://skmtc.dev/calcom/apis/cal-diy-api-v2/changes/v2/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/88d9aa0ca488/schema)