Delete List

curl --request DELETE \
  --url https://api.example.com/v1/lists/{id}

{
  "data": {
    "deleted": true,
    "id": "<string>",
    "memberships_removed": 123
  }
}

DELETE

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

string

required

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

data

object

Show properties

deleted

boolean

Always true on success

string

ID of the deleted list

memberships_removed

integer

Number of contact memberships that were removed

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

Create List Add Contacts to List

​Request

​Path Parameters

​Headers

​Response

​Example Response

​Errors

Request

Path Parameters

Headers

Response

Example Response

Errors