v1

latestOpenAPI 3.0.3Proprietary2026-08-0656136286.9 KB

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

Request body

idsstring[] required

Array of subscription IDs to delete

Example request

{
  "ids": [
    "507f1f77bcf86cd799439011",
    "507f1f77bcf86cd799439012"
  ]
}

Response

Delete operation completed (full or partial success)

totalinteger required

successfulinteger required

failedinteger required

Example response

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