---
title: "Delete a webhook configuration"
description: "Deletes a webhook configuration. Returns `409` if any subscription uses it."
canonical: https://y2.dev/docs/api/reference/webhooks/deleteWebhook/
---

Endpoint Reference[Webhooks](https://y2.dev/docs/api/reference/webhooks)

# Delete a webhook configuration

Deletes a webhook configuration. Returns \`409\` if any subscription uses it.

`DELETE https://api.y2.dev/api/v1/webhooks/{webhookId}`

- Operation ID: `deleteWebhook`
- Required scopes: `webhooks:manage`
- Contract: https://y2.dev/openapi.json

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `webhookId` | path | string | Yes | Stable public webhook configuration ID. |
| `If-Match` | header | string | No | Strong ETag from the latest representation. A mismatch returns 412. |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| 204 | Webhook configuration deleted. The response has no body. |  |
| 401 | Missing or invalid API key |  |
| 403 | Insufficient permissions or access denied |  |
| 404 | Resource not found |  |
| 409 | Resource conflict (e.g., webhook in use) |  |
| 412 | The supplied If-Match validator does not match the current representation. |  |
| 429 | Rate limit exceeded (per-key or per-account aggregate) |  |
| 500 | Internal server error |  |
