---
title: "Update a webhook"
method: PUT
path: "/webhooks/{webhookID}"
tags: ["Webhooks"]
---

# Update a webhook

`PUT /webhooks/{webhookID}`

Update the specified webhook object

## Request body

- PutWebhookPayload
  - `url` string — The new HTTPS URL that Bridge will send events to.
  - `status` 'active' | 'disabled' — The new status of the webhook endpoint. If set to "active", the webhook will be enabled and will send requests to the new URL. If set to "disabled", the webhook will be disabled and will not send requests to the URL.
  - `event_categories` WebhookEventCategory[] — The list of event categories that the webhook endpoint will receive. Note that if modified, the webhook endpoint will receive events for new categories only from the current point onwards.

## Response `200`

Successful webhook object response

- Webhook
  - `id` string, required — An identifier that uniquely identifies the webhook endpoint
  - `url` string, required — The URL that the webhook will send events to
  - `status` 'active' | 'disabled' | 'deleted', required — The status of the webhook. Only active webhooks will receive events automatically.
  - `public_key` string, required — The public key (in PEM format) that should be used to verify the authenticity of webhook events
  - `event_categories` WebhookEventCategory[] — The list of event categories that the webhook endpoint will receive

## Other responses

- `401` — Missing or invalid API key
- `404` — No resource found
- `500` — Unexpected error. User may try and send the request again.

---

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