---
title: "Update Webhook Subscription"
method: PATCH
path: "/api/v1/webhook-subscriptions/{id}"
tags: ["Webhook Subscriptions"]
---

# Update Webhook Subscription

`PATCH /api/v1/webhook-subscriptions/{id}`

Update an existing webhook subscription configuration.

## Request body

- object — Webhook subscription update configuration
  - `webhookSubscription` object, required
    - `url` string, uri — HTTPS URL that will receive webhook events
    - `enabled` boolean — Whether the webhook subscription is active
    - `subscribedEvents` string[] — List of events to subscribe to

## Response `200`

Webhook subscription updated successfully

- object
  - `data` WebhookSubscriptionResponse
    - `id` string — Unique identifier for the webhook subscription
    - `type` 'webhookSubscription' — Type of the resource
    - `attributes` object
      - `url` string, uri — HTTPS URL that will receive webhook events
      - `secretKey` string — Secret key used to sign webhook payloads
      - `enabled` boolean — Whether the webhook subscription is active
      - `scopeType` 'organisation' | 'entity' — Scope type for the webhook subscription
      - `scopeName` string — Name of the scope
      - `subscribedEvents` string[] — List of events subscribed to

## Other responses

- `400` — Bad Request - Invalid webhook subscription data
- `401` — Unauthorized - Invalid API key
- `404` — Not Found - Webhook subscription not found
- `422` — Unprocessable Entity - Invalid webhook URL or configuration

---

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