---
title: "Changes to Create Webhook"
method: POST
path: "/v1/configs/{configId}/environments/{environmentId}/webhooks"
---

# Changes to Create Webhook

`POST /v1/configs/{configId}/environments/{environmentId}/webhooks`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 16 revisions.

- **2025-10-09** `8b8a102e5ed1`: 17 breaking, 6 info
- **2025-05-16** `2949501eef38`: 6 breaking, 17 info
- **2024-11-02** `5e41b01aba83`: 11 info
- **2024-05-18** `f14408c16a8c`: 1 info

## Changes

- **2025-10-09** `8b8a102e5ed1`: 17 breaking, 6 info
  - added `#/components/schemas/WebHookHttpMethod` to the `httpMethod` request property `allOf` list (media type: application/json)
  - added `#/components/schemas/WebHookHttpMethod` to the `httpMethod` request property `allOf` list (media type: text/json)
  - added `#/components/schemas/WebHookHttpMethod` to the `httpMethod` request property `allOf` list (media type: application/*+json)
  - the request property `webHookHeaders/items/key` became not nullable (media type: application/json)
  - the request property `webHookHeaders/items/key` became not nullable (media type: text/json)
  - the request property `webHookHeaders/items/key` became not nullable (media type: application/*+json)
  - the request property `webHookHeaders/items/value` became not nullable (media type: application/json)
  - the request property `webHookHeaders/items/value` became not nullable (media type: text/json)
  - the request property `webHookHeaders/items/value` became not nullable (media type: application/*+json)
  - removed the enum value `get` of the request property `httpMethod` (media type: application/json)
  - removed the enum value `get` of the request property `httpMethod` (media type: text/json)
  - removed the enum value `get` of the request property `httpMethod` (media type: application/*+json)
  - removed the enum value `post` of the request property `httpMethod` (media type: application/json)
  - removed the enum value `post` of the request property `httpMethod` (media type: text/json)
  - removed the enum value `post` of the request property `httpMethod` (media type: application/*+json)
  - the `httpMethod` request property type changed from `string` to no type (media type: application/json)
  - the `httpMethod` request property type changed from `string` to no type (media type: application/*+json)
  - the request property `httpMethod` became nullable (media type: application/json)
  - the request property `httpMethod` became nullable (media type: text/json)
  - the request property `httpMethod` became nullable (media type: application/*+json)
  - the `httpMethod` request property type was generalized from `string` to no type (media type: text/json)
  - the response property `content` became required for the status `201`
  - the response property `webHookHeaders/items/value` became required for the status `201`
- **2025-05-16** `2949501eef38`: 6 breaking, 17 info
  - the response property `webHookHeaders/items/value` became nullable for the status `201`
  - the response property `webHookHeaders/items/value` became optional for the status `201`
  - the `webHookHeaders/items/key` response property's maxLength was unset from `255` for the response status `201`
  - the `webHookHeaders/items/value` response property's maxLength was unset from `1000` for the response status `201`
  - the `webHookHeaders/items/key` response property's minLength was decreased from `1` to `0` for the response status `201`
  - the `webHookHeaders/items/value` response property's minLength was decreased from `1` to `0` for the response status `201`
  - the request property `webHookHeaders/items/key` became nullable (media type: application/json)
  - the request property `webHookHeaders/items/key` became nullable (media type: text/json)
  - the request property `webHookHeaders/items/key` became nullable (media type: application/*+json)
  - the request property `webHookHeaders/items/value` became nullable (media type: application/json)
  - the request property `webHookHeaders/items/value` became nullable (media type: text/json)
  - the request property `webHookHeaders/items/value` became nullable (media type: application/*+json)
  - the response property `config` became required for the status `201`
  - the response property `config/configId` became required for the status `201`
  - the response property `config/name` became required for the status `201`
  - the response property `environment` became required for the status `201`
  - the response property `environment/environmentId` became required for the status `201`
  - the response property `environment/name` became required for the status `201`
  - the response property `httpMethod` became required for the status `201`
  - the response property `url` became required for the status `201`
  - the response property `webHookHeaders` became required for the status `201`
  - the response property `webHookHeaders/items/isSecure` became required for the status `201`
  - the response property `webhookId` became required for the status `201`
- **2024-11-02** `5e41b01aba83`: 11 info
  - removed the pattern `^(https?:\/\/(?:www\.|(?!www)|(?!a-zA-Z))[a-zA-Z0-9][a-zA-Z0-9-]*[a-zA-Z0-9]\.[^\s]{2,}|https?:\/\/(?:www\.|(?!www)|(?!a-zA-Z))[a-zA-Z0-9]\.[^\s]{2,})$` from the request property `url` (media type: application/json)
  - removed the pattern `^(https?:\/\/(?:www\.|(?!www)|(?!a-zA-Z))[a-zA-Z0-9][a-zA-Z0-9-]*[a-zA-Z0-9]\.[^\s]{2,}|https?:\/\/(?:www\.|(?!www)|(?!a-zA-Z))[a-zA-Z0-9]\.[^\s]{2,})$` from the request property `url` (media type: text/json)
  - removed the pattern `^(https?:\/\/(?:www\.|(?!www)|(?!a-zA-Z))[a-zA-Z0-9][a-zA-Z0-9-]*[a-zA-Z0-9]\.[^\s]{2,}|https?:\/\/(?:www\.|(?!www)|(?!a-zA-Z))[a-zA-Z0-9]\.[^\s]{2,})$` from the request property `url` (media type: application/*+json)
  - removed the pattern `^[a-zA-Z0-9\- _\\:;.,\/"'?!(){}\[\]@<>=+*#$&`|~^%]*$` from the request property `webHookHeaders/items/value` (media type: application/json)
  - removed the pattern `^[a-zA-Z0-9\- _\\:;.,\/"'?!(){}\[\]@<>=+*#$&`|~^%]*$` from the request property `webHookHeaders/items/value` (media type: text/json)
  - removed the pattern `^[a-zA-Z0-9\- _\\:;.,\/"'?!(){}\[\]@<>=+*#$&`|~^%]*$` from the request property `webHookHeaders/items/value` (media type: application/*+json)
  - removed the pattern `^[a-zA-Z0-9_\-]*$` from the request property `webHookHeaders/items/key` (media type: application/json)
  - removed the pattern `^[a-zA-Z0-9_\-]*$` from the request property `webHookHeaders/items/key` (media type: text/json)
  - removed the pattern `^[a-zA-Z0-9_\-]*$` from the request property `webHookHeaders/items/key` (media type: application/*+json)
  - the `webHookHeaders/items/key` response's property pattern `^[a-zA-Z0-9_\-]*$` was removed for the status `201`
  - the `webHookHeaders/items/value` response's property pattern `^[a-zA-Z0-9\- _\\:;.,\/"'?!(){}\[\]@<>=+*#$&`|~^%]*$` was removed for the status `201`
- **2024-05-18** `f14408c16a8c`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/configcat/apis/configcat-public-management-api/docs/v1/configs/:configId/environments/:environmentId/webhooks/post.md) - [API](https://skmtc.dev/configcat/apis/configcat-public-management-api.md) - [Page](https://skmtc.dev/configcat/apis/configcat-public-management-api/changes/v1/configs/:configId/environments/:environmentId/webhooks/post)
