Webhooks

Delete Subscriptions

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

POST

api

subscriptions

delete

curl --request POST \
  --url https://api.lusha.com/api/subscriptions/delete \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "ids": [
    "sub-123"
  ]
}
'

{
  "total": 3,
  "successful": 3,
  "failed": 0,
  "results": [
    {
      "index": 0,
      "success": true,
      "subscription": {
        "id": "sub-123",
        "entityType": "contact",
        "entityId": "123",
        "name": "Contact Webhook"
      }
    },
    {
      "index": 1,
      "success": true,
      "subscription": {
        "id": "sub-456",
        "entityType": "company",
        "entityId": "456",
        "name": "Company Webhook"
      }
    },
    {
      "index": 2,
      "success": true,
      "subscription": {
        "id": "sub-789",
        "entityType": "contact",
        "entityId": "789"
      }
    }
  ]
}

Authorizations

api_key

string

header

required

Your Lusha API key. You can find this in your Lusha dashboard under API settings.

Include this key in the api_key header for all requests.

Body

application/json

ids

string[]

required

Array of subscription IDs to delete

Required array length: 1 - 25 elements

Example:

[
  "507f1f77bcf86cd799439011",
  "507f1f77bcf86cd799439012"
]

Response

Delete operation completed (full or partial success)

total

integer

required

Total number of deletion attempts

Example:

3

successful

integer

required

Number of successfully deleted subscriptions

Example:

2

failed

integer

required

Number of failed deletion attempts

Example:

1

results

object[]

required

Option 1
Option 2

Show child attributes

⌘I

curl --request POST \
  --url https://api.lusha.com/api/subscriptions/delete \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "ids": [
    "sub-123"
  ]
}
'

{
  "total": 3,
  "successful": 3,
  "failed": 0,
  "results": [
    {
      "index": 0,
      "success": true,
      "subscription": {
        "id": "sub-123",
        "entityType": "contact",
        "entityId": "123",
        "name": "Contact Webhook"
      }
    },
    {
      "index": 1,
      "success": true,
      "subscription": {
        "id": "sub-456",
        "entityType": "company",
        "entityId": "456",
        "name": "Company Webhook"
      }
    },
    {
      "index": 2,
      "success": true,
      "subscription": {
        "id": "sub-789",
        "entityType": "contact",
        "entityId": "789"
      }
    }
  ]
}

Overview

Resources

Endpoints

Delete Subscriptions

Authorizations

Body

Response