---
title: "Replace the events of a webhook"
method: PUT
path: "/webhooks/{webhookId}/events"
tags: ["webhook"]
---

# Replace the events of a webhook

`PUT /webhooks/{webhookId}/events`

Replaces the **whole** set of events delivered to a webhook. Events that are not in the request are unsubscribed, so this is the operation to use when your integration owns the full list.

To add events without knowing the current list, use `PATCH /webhooks/{webhookId}/events` instead.

The target URL is immutable, so the `uuid` of the webhook does not change.

**Permission:** No specific permission required. A valid API key is sufficient.

**Monitoring:** Not needed.

## Path parameters

- `webhookId` string, uuid, required

## Request body

- RequestWebhookEvents
  - `events` WebhookEvent[], required — The events to apply to the subscription (mandatory, at least one, no duplicates).

## Response `200`

Successful operation — returns the updated subscription.

- WebhookSubscription
  - `uuid` string, uuid, required — The identifier of the webhook: an RFC 4122 v5 UUID derived from `target_url` in the URL namespace. The same target URL always yields the same identifier, and it is stable for the lifetime of the subscription.
  - `target_url` string, uri, required — The URL Ringover POSTs the subscribed events to. Immutable.
  - `events` WebhookEvent[], required — The events delivered to `target_url`, in catalog order.
  - `signing_key` string — The key used to sign the deliveries sent to your endpoints (see *Securing your webhooks* in the `webhook` tag description). Read-only and shared by every subscription of your configuration. Absent while no key has been generated yet.

## Other responses

- `400` — The payload is malformed — `events` is empty or one of the events is not part of the catalog
- `401` — Authentication token is missing, invalid, or expired
- `403` — The API key is not allowed to manage webhooks
- `404` — No webhook matches this identifier
- `500` — Internal server error

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)