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

---

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