---
title: "Delete Webhook Subscription"
method: DELETE
path: "/v1/webhooks/{id}"
tags: ["Webhooks"]
---

# Delete Webhook Subscription

`DELETE /v1/webhooks/{id}`

This operation performs a soft delete by setting `is_active = false` and `deleted_at = NOW()`.
The subscription will no longer receive webhook events.

## Rules
- Only the bank account that owns the subscription can delete it.
- Attempting to delete a subscription from another account returns 404 (not 403, to avoid leaking existence).
- Deleting an already-deleted subscription returns 404.

Requires `ManageWebhooks` permission.

## Path parameters

- `id` integer, required

## Response `204`

Webhook subscription deleted successfully

## Other responses

- `401` — Authentication failed - invalid or missing service account credentials
- `403` — Access denied - service account requires ManageWebhooks permission
- `404` — Webhook subscription not found. Error code: WEBHOOK_NOT_FOUND
- `500` — Internal server error. Error code: INTERNAL_ERROR

---

[API](https://skmtc.net/kiwify/apis/conta-digital-api.md) · [All operations](https://skmtc.net/kiwify/apis/conta-digital-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kiwify/conta-digital-api/revisions/5e009b25c245/schema)