---
title: "Delete a webhook subscription"
method: DELETE
path: "/api/v1/webhooks/{webhookId}"
tags: ["webhooks"]
---

# Delete a webhook subscription

`DELETE /api/v1/webhooks/{webhookId}`

## Request

- Base URL: `https://api.textbee.dev`
- URL: `https://api.textbee.dev/api/v1/webhooks/{webhookId}`
- Auth: API key in header `x-api-key`

Stops all deliveries for this subscription. Its delivery history stays readable through GET /webhooks/notifications.

## Path parameters

- `webhookId` string, required

## Response `200`

The subscription was deleted.

- WebhookDeletedResponseDTO
  - `data` WebhookDeletedResultDTO, required
    - `success` boolean, required: Whether the delete succeeded.

## Other responses

- `401`: Missing, invalid, or revoked API key.
- `404`: No webhook subscription with that id on your account.

---

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