---
title: "Update a webhook endpoint"
method: PATCH
path: "/v4/webhook_endpoints/{id}"
tags: ["Webhooks"]
---

# Update a webhook endpoint

`PATCH /v4/webhook_endpoints/{id}`

## Request

- Base URL: `https://api.kit.com`
- URL: `https://api.kit.com/v4/webhook_endpoints/{id}`
- Auth: one of:
  - API key in header `X-Kit-Api-Key`
  - OAuth 2
    - Authorization code: `https://api.kit.com/v4/oauth/authorize`
    - Token URL: `https://api.kit.com/v4/oauth/token`

Updates any of `name`, `url`, `description`, `status`, and `events`. Set `status` to `disabled` to stop deliveries without deleting the endpoint, and back to `active` to resume.

**Note:** `events` replaces the endpoint's entire subscription list — send the complete set you want, not just the additions.

Endpoints created by an app (via OAuth) can only be updated by that app; an API key request returns `403`.

## Path parameters

- `id` integer, required

## Request body

- object
  - `name` string
  - `url` string
  - `description` string
  - `status` 'active' | 'disabled': Endpoint status. One of: `active`, `disabled`.
  - `events` string[]: Event types this endpoint subscribes to (e.g. `subscriber.created`). On update, the list supplied here replaces the endpoint's full subscription list.

## Response `200`

Updates the webhook endpoint

- object
  - `webhook_endpoint` object, required
    - `id` integer, required
    - `name` string, required
    - `url` string, required
    - `events` string[], required
    - `status` string, required
    - `source` string, required
    - `description` string, required
    - `created_by_app` unknown, required
    - `created_at` string, required
    - `previous_secret_expires_at` unknown, required

## Other responses

- `404`: Returns a 404 when the provided id does not exist

## Changes

- **2026-11-03** `f04308f83b63`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kit/apis/kit-api/changes/v4/webhook_endpoints/:id/patch.md)

---

[API](https://skmtc.dev/kit/apis/kit-api.md) - [All operations](https://skmtc.dev/kit/apis/kit-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kit/apis/kit-api/revisions/f04308f83b63?raw)