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
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
Array of subscription IDs to delete
Required array length:
1 - 25 elementsExample:
[
"507f1f77bcf86cd799439011",
"507f1f77bcf86cd799439012"
]
Response
Delete operation completed (full or partial success)
Was this page helpful?
⌘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"
}
}
]
}