---
title: "Update Webhook"
method: PATCH
path: "/webhooks/{id}"
tags: ["webhooks"]
---

# Update Webhook

`PATCH /webhooks/{id}`

This endpoint updates a webhook. At least one field must be provided for update.

## Path parameters

- `id` string, required

## Request body

- object
  - `hookUrl` string — Update the webhook URL. Must be a valid HTTP or HTTPS URL
  - `integrationName` string — Update the integration name
  - `integrationMetadata` object — Update the integration metadata
  - `integrationType` string — Update the integration type
  - `type` string — Update the webhook type
  - `isSubscribed` boolean — Update the subscription status
  - `name` string — Update the webhook name

## Response `200`

200 OK

- object
  - `id` string — Unique identifier of the webhook subscription
  - `subscribed_at` string — Timestamp when the webhook was subscribed
  - `is_subscribed` boolean — Whether the webhook is currently active
  - `integration_name` string — Name of the event this webhook listens to
  - `integration_type` string — Type of integration
  - `type` string — Type of the subscription
  - `integration_metadata` object — Additional metadata about the integration
    - `id` string — Metadata ID
    - `name` string — Metadata name or identifier
  - `org_id` string — Organization ID that owns this webhook
  - `hook_url` string — The URL where webhook events are sent
  - `integration_id` string — Unique identifier of the integration

## Other responses

- `404` — Webhook not found

---

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