---
title: "delete webhook subscription"
method: DELETE
path: "/instances/{id}/webhooks/{subscriptionId}"
tags: ["webhooks"]
---

# delete webhook subscription

`DELETE /instances/{id}/webhooks/{subscriptionId}`

## Request

- Base URL: `https://waapi.app/api/v1`
- URL: `https://waapi.app/api/v1/instances/{id}/webhooks/{subscriptionId}`
- Auth: HTTP bearer

Remove a webhook subscription from an instance. A subscription id that does not belong to this instance is reported as not found, not forbidden.

## Path parameters

- `id` integer, required
- `subscriptionId` integer, required

## Response `204`

No Content.

## Other responses

- `401`: Unauthorized — invalid or missing bearer token
- `403`: Forbidden — insufficient permissions or account blocked
- `404`: Not found — subscription does not exist or does not belong to this instance
- `409`: Conflict — instance is not ready
- `422`: Validation error — invalid or missing request parameters
- `429`: Too many requests — rate limit exceeded

---

[API](https://skmtc.dev/waapi/apis/waapi-api-2.md) · [All operations](https://skmtc.dev/waapi/apis/waapi-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/waapi/apis/waapi-api-2/revisions/490302f75576?raw)