---
title: "Changes to Create Webhook"
method: POST
path: "/webhooks"
---

# Changes to Create Webhook

`POST /webhooks`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `5012671cf95d`: 7 breaking, 11 warning, 31 info

## Changes

- **2026-11-03** `5012671cf95d`: 7 breaking, 11 warning, 31 info
  - the request property `method` became required
  - the request property `webhookTrigger` became required
  - the `filter` request property type changed from `object` to no type
  - the `params` request property type changed from `object` to no type
  - the `filter` response's property type changed from `object` to no type for status `201`
  - the `headers` response's property type changed from `object` to no type for status `201`
  - the `params` response's property type changed from `object` to no type for status `201`
  - the `name` request property's maxLength was set to `255`
  - the `url` request property's maxLength was set to `255`
  - removed the request property `filter/stream_id`
  - removed the optional property `filter/stream_id` from the response with the `201` status
  - removed the optional property `params/extended` from the response with the `201` status
  - removed the optional property `params/include_contact_details` from the response with the `201` status
  - removed the optional property `params/include_lead_id` from the response with the `201` status
  - removed the optional property `params/include_message_text` from the response with the `201` status
  - removed the optional property `params/send_bulk` from the response with the `201` status
  - added the new `UNKNOWN` enum value to the `method` response property for the response status `201`
  - added the new `UNKNOWN` enum value to the `webhookTrigger` response property for the response status `201`
  - api operation id `createWebhook` removed and replaced with `create_webhook`
  - the endpoint scheme security `APIKeyHeader` was added to the API
  - api tag `Webhooks` added
  - api tag `Webhooks management` removed
  - added `#/components/schemas/WebhookFilter, subschema #2` to the `filter` request property `anyOf` list
  - added `#/components/schemas/WebhookParams, subschema #2` to the `params` request property `anyOf` list
  - the request property `headers` became optional
  - the request property `retries` became optional
  - the `activated` request property default value `true` was added
  - the `headers` request property default value `{}` was added
  - the `retries` request property default value `0` was added
  - request property `activated` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `headers` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `retries` list-of-types was widened by adding types `null` to media type `application/json`
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `422`
  - added the non-success response with the status `500`
  - the response property `activated` became required for the status `201`
  - the response property `createdAt` became required for the status `201`
  - the response property `filter` became required for the status `201`
  - …9 more

---

[Operation](https://skmtc.dev/commpeak/apis/dialer-api-v2-0-1/docs/webhooks/post.md) - [API](https://skmtc.dev/commpeak/apis/dialer-api-v2-0-1.md) - [Page](https://skmtc.dev/commpeak/apis/dialer-api-v2-0-1/changes/webhooks/post)