---
title: "Create a webhook"
method: POST
path: "/v2/webhooks"
tags: ["Webhooks"]
---

# Create a webhook

`POST /v2/webhooks`

## Headers

- `Authorization` 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`

- 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
    - `triggers` string[], required
    - `userId` number, 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-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`

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