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

# Create a webhook

`POST /v2/oauth-clients/{clientId}/webhooks`

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

## Path parameters

- `clientId` string, required

## Headers

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

## Request body

- CreateWebhookInputDto
  - `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, required
  - `subscriberUrl` string, required
  - `triggers` string[], required
  - `secret` string
  - `version` '2021-10-20' — The version of the webhook

## Response `201`

- 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 `201`
- **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
- **2026-01-06** (v2) `2ecd46907a81` — 1 info
  - added the new optional request property `version`

[Full history](https://skmtc.dev/calcom/apis/cal-diy-api-v2/changes/v2/oauth-clients/:clientId/webhooks/post.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)