---
title: "Delete a webhook"
method: DELETE
path: "/webhooks/{webhookId}"
tags: ["webhook"]
---

# Delete a webhook

`DELETE /webhooks/{webhookId}`

Deletes a webhook subscription. Its target URL is unsubscribed from **every** event and stops receiving deliveries. The other subscriptions of your configuration are untouched.

Since `target_url` is immutable, deleting and re-creating is also how you move a subscription to another URL.

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

**Monitoring:** Not needed.

## Path parameters

- `webhookId` string, uuid, required

## Response `204`

Webhook deleted — no content returned.

## Other responses

- `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)