Contacts
Companies
Deals
Pipelines
Lists
Tags
Campaigns
- GETList Campaigns
- POSTCreate Campaign
- GETGet Campaign
- PATCHUpdate Campaign
- DELDelete Campaign
- POSTStart Campaign
- POSTPause Campaign
- GETList Campaign Contacts
- POSTAdd Contacts to Campaign
- DELRemove Contact from Campaign
- GETList Campaign Steps
- POSTCreate Campaign Step
- PATCHUpdate Campaign Step
- DELDelete Campaign Step
- GETCampaign Stats
- GETCampaign Event Stream
Users
Stats & Analytics
Lexi AI
Audit Logs
AI Analysis
Documents
Import & Export
Workflows
Events
Delete List
curl --request DELETE \
--url https://api.example.com/v1/lists/{id}{
"data": {
"deleted": true,
"id": "<string>",
"memberships_removed": 123
}
}Lists
Delete List
Permanently delete a list and all its memberships
DELETE
/
v1
/
lists
/
{id}
Delete List
curl --request DELETE \
--url https://api.example.com/v1/lists/{id}{
"data": {
"deleted": true,
"id": "<string>",
"memberships_removed": 123
}
}Request
Path Parameters
The list’s unique ID (UUID)
Headers
Authorization: Bearer wbk_your_api_key_here
Requires an API key with the
contacts:write permission.Deletion is permanent. The list and all its memberships are removed. Contacts themselves are not deleted — only their association with this list. Fires the
list.deleted webhook event.Response
curl -X DELETE https://data.leadlex.com/functions/v1/api-gateway/v1/lists/l1b2c3d4-e5f6-7890-abcd-ef1234567890 \
-H "Authorization: Bearer wbk_your_api_key_here"
Example Response
{
"data": {
"deleted": true,
"id": "l1b2c3d4-e5f6-7890-abcd-ef1234567890",
"memberships_removed": 42
}
}
Errors
| Status | Code | Description |
|---|---|---|
| 401 | invalid_key | Invalid or expired API key |
| 403 | insufficient_permissions | Missing contacts:write permission |
| 404 | list_not_found | No list with this ID in your workspace |
| 429 | rate_limited | Rate limit exceeded |
⌘I