---
title: "Replace Webhook"
method: PUT
path: "/v1/webhooks/{webhookId}"
tags: ["Webhooks"]
---

# Replace Webhook

`PUT /v1/webhooks/{webhookId}`

This endpoint replaces the whole value of a Webhook identified by the `webhookId` parameter.

**Important:** As this endpoint is doing a complete replace, it's important to set every other attribute that you don't
want to change in its original state. Not listing one means it will reset.

## Path parameters

- `webhookId` integer, required

## Request body

- WebHookRequestModel
  - `url` string, required — The URL of the Webhook.
  - `content` string, nullable — The HTTP body content.
  - `httpMethod` 'get' | 'post'
  - `webHookHeaders` WebhookHeaderModel[], nullable — List of HTTP headers.
    - `key` string, required — The HTTP header key.
    - `value` string, required — The HTTP header value.
    - `isSecure` boolean — Indicates whether the header value is sensitive.

## Response `200`

When the replace was successful.

- WebhookResponseModel
  - `webhookId` integer, required — The identifier of the Webhook.
  - `url` string, required — The URL of the Webhook.
  - `httpMethod` 'get' | 'post', required
  - `content` string, nullable, required — The HTTP body content.
  - `webHookHeaders` WebhookHeaderResponseModel[], required — List of HTTP headers that the Webhook must send.
    - `key` string, required — The HTTP header key.
    - `value` string, required — The HTTP header value.
    - `isSecure` boolean, required — Indicates whether the header value is sensitive.
  - `config` WebhookConfig, required — The Config where the applied changes will invoke the Webhook.
    - `name` string, required — The Config's name.
    - `configId` string, uuid, required — The Config's identifier.
  - `environment` WebhookEnvironment, required — The Environment where the applied changes will invoke the Webhook.
    - `name` string, required — The Environment's name.
    - `environmentId` string, uuid, required — The Environment's identifier.

## Other responses

- `400` — Bad request.
- `404` — Not found.
- `429` — Too many requests. In case of the request rate exceeds the rate limits.

---

[API](https://skmtc.net/configcat/apis/configcat-public-management-api.md) · [All operations](https://skmtc.net/configcat/apis/configcat-public-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/configcat/configcat-public-management-api/versions/6b4d53bc1455/schema)