> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete a webhook endpoint

> Delete an integration webhook endpoint with If-Match. Pending deliveries are cancelled, and the delivery log stays readable for 30 days after deletion.

Deletes the endpoint. Pending deliveries are cancelled. The delivery log stays
readable for 30 days.

Integration webhooks require an active Business, Agency Business or Enterprise plan. Changing an endpoint also requires an API token with write access enabled by an Owner or Manager. See [Integration webhooks](https://docs.qwairy.co/developers/integration-webhooks/overview.md) and [Writing data](https://docs.qwairy.co/developers/writing-data.md).

**Authorization** `string` *required*

Bearer token for your team.

**If-Match** `string` *required*

The `ETag` from [Get a webhook endpoint](https://docs.qwairy.co/developers/endpoints/webhooks/get.md), including its quotes. Use `*` to delete unconditionally.

**webhookId** `string` *required*

Endpoint identifier.

## Response

Returns `204` with no body.

## Synthetic request

```bash theme={null}
curl -X DELETE "https://www.qwairy.co/api/v1/webhooks/$WEBHOOK_ID" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN" \
  -H 'If-Match: "1"'
```

## Errors

| Status | Code | Cause |
| - | - | - |
| `404` | `RESOURCE_NOT_FOUND` | The endpoint is missing or belongs to another team |
| `412` | `PRECONDITION_FAILED` | The endpoint changed since your read |
| `428` | `PRECONDITION_REQUIRED` | `If-Match` is missing |

See [Error codes](https://docs.qwairy.co/developers/errors.md) for authentication, plan, idempotency and server errors. A token without write access returns `403 API_KEY_READ_ONLY`. On `429`, honor `Retry-After`. If the write limiter is unavailable or writes are suspended, the request returns `503 SERVICE_UNAVAILABLE` and nothing changes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.