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>"
  }
}

DELETE

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

Show properties

removed

boolean

Always true on success

list_id

string

ID of the list

contact_id

string

ID of the contact that was removed from the list

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

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
404	`membership_not_found`	Contact is not a member of this list
429	`rate_limited`	Rate limit exceeded

Add Contacts to List List Tags

​Request

​Path Parameters

​Headers

​Response

​Example Response

​Errors

Request

Path Parameters

Headers

Response

Example Response

Errors