Skip to main content
DELETE
/
v1
/
lists
/
{list_id}
/
contacts
/
{contact_id}
Remove Contact from List
curl --request DELETE \
  --url https://api.example.com/v1/lists/{list_id}/contacts/{contact_id}
{
  "data": {
    "removed": true,
    "list_id": "<string>",
    "contact_id": "<string>"
  }
}

​
Request

​
Path Parameters

​
list_id
string
required
The list’s unique ID (UUID)
​
contact_id
string
required
The contact’s unique ID (UUID)

​
Headers

Authorization: Bearer wbk_your_api_key_here
Requires an API key with the contacts:write permission. Only the list membership is removed — the contact itself is preserved. Fires the list.contacts_removed webhook event.

​
Response

​
data
object
curl -X DELETE https://data.leadlex.com/functions/v1/api-gateway/v1/lists/l1b2c3d4-e5f6-7890-abcd-ef1234567890/contacts/123e4567-e89b-12d3-a456-426614174000 \
  -H "Authorization: Bearer wbk_your_api_key_here"

​
Example Response

{
  "data": {
    "removed": true,
    "list_id": "l1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "contact_id": "123e4567-e89b-12d3-a456-426614174000"
  }
}

​
Errors

StatusCodeDescription
401invalid_keyInvalid or expired API key
403insufficient_permissionsMissing contacts:write permission
404list_not_foundNo list with this ID
404membership_not_foundContact is not a member of this list
429rate_limitedRate limit exceeded