---
title: "Delete a webhook subscription"
method: DELETE
path: "/v5/webhooks/{webhook_id}"
tags: ["Webhooks"]
---

# Delete a webhook subscription

`DELETE /v5/webhooks/{webhook_id}`

## Request

- Base URL: `https://headlessoracle.com`
- URL: `https://headlessoracle.com/v5/webhooks/{webhook_id}`
- Auth: API key in header `X-Oracle-Key`

Permanently removes the webhook subscription. Returns 204 No Content on success. Also decrements the plan webhook count.

## Path parameters

- `webhook_id` string, required

## Response `204`

Webhook deleted

## Other responses

- `401`: Missing API key
- `403`: Invalid API key or webhook does not belong to this key
- `404`: Webhook not found

---

[API](https://skmtc.dev/headlessoracle/apis/headless-oracle.md) · [All operations](https://skmtc.dev/headlessoracle/apis/headless-oracle/llms.txt) · [OpenAPI document](https://skmtc.dev/headlessoracle/apis/headless-oracle/revisions/4e82fe332f29?raw)