---
title: "Delete Subscriptions"
method: POST
path: "/api/subscriptions/delete"
tags: ["Webhooks"]
---

# Delete Subscriptions

`POST /api/subscriptions/delete`

Delete one or more webhook subscriptions. Returns detailed results for each deletion with partial success support.

*Endpoint*: **(POST) https://api.lusha.com/api/subscriptions/delete**

---

**Behavior:**
- Each subscription is processed independently
- Returns detailed results for each item including deleted subscription info
- Invalid ID formats are gracefully handled and reported as NOT_FOUND
- Duplicate IDs are automatically deduplicated
- Deletion is permanent and cannot be undone

## Request body

- object
  - `ids` string[], required — Array of subscription IDs to delete

## Response `200`

Delete operation completed (full or partial success)

- DeleteSubscriptionResponse
  - `total` integer, required
  - `successful` integer, required
  - `failed` integer, required
  - `results` union[], required
    - union
      - DeleteSubscriptionSuccessResult
        - `index` integer, required
        - `success` true, required
        - `subscription` object, required
          - `id` string
          - `entityType` string
          - `entityId` string
          - `name` string
      - DeleteSubscriptionErrorResult
        - `index` integer, required
        - `success` false, required
        - `error` object, required
          - `code` 'NOT_FOUND' | 'VALIDATION_ERROR' | 'FORBIDDEN' | 'UNKNOWN_ERROR', required
          - `message` string, required

## Other responses

- `400` — Bad request - invalid input data
- `401` — Unauthorized - invalid or missing API key
- `500` — Internal server error

---

[API](https://skmtc.net/lusha/apis/lusha-api-documentation.md) · [All operations](https://skmtc.net/lusha/apis/lusha-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lusha/lusha-api-documentation/revisions/4c51e40e3e67/schema)