---
title: "Update a webhook"
method: PATCH
path: "/v1/webhooks/{id}"
tags: ["Webhooks"]
---

# Update a webhook

`PATCH /v1/webhooks/{id}`

Update webhook URL, events, or status. **Requires a secret key (sk_).**

## Path parameters

- `id` string, required

## Request body

- object
  - `url` string, uri — New webhook URL
  - `events` string[] — Events to subscribe to
  - `description` string
  - `isActive` boolean — Enable/disable the webhook

## Response `200`

Webhook updated

- object — Webhook updated
  - `id` string, required — Unique identifier for the webhook
  - `url` string, uri, required — The HTTPS endpoint that receives webhook payloads
  - `events` string[], required — List of event types this webhook subscribes to
  - `isActive` boolean, required — Whether the webhook is currently receiving events
  - `secret` string — Secret key for verifying webhook signatures (only returned on creation)
  - `description` string — Optional description for this webhook
  - `createdAt` string, date-time — When the webhook was created

## Other responses

- `400` — Invalid URL
- `401` — Unauthorized
- `404` — Webhook not found

---

[API](https://skmtc.net/usedrip/apis/drip-api.md) · [All operations](https://skmtc.net/usedrip/apis/drip-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usedrip/drip-api/versions/2cb1567969ca/schema)