Skip to main content
POST
/
v1
/
lists
/
{list_id}
/
items
Add Items to List
curl --request POST \
  --url https://api.example.com/v1/lists/{list_id}/items \
  --header 'Content-Type: application/json' \
  --data '
{
  "ids": [
    {}
  ],
  "id_type": "<string>"
}
'
{
  "data": {
    "added": 42
  }
}
Add specific property or person IDs to an existing list. Up to 10,000 IDs per request. Duplicates are ignored. FREE — no credits consumed.
​
list_id
string
required
The list ID to add items to.
​
ids
array
required
Array of property or person IDs to add (1-10,000 per request).
​
id_type
string
default:"internal_property_id"
Type of IDs: internal_property_id or internal_person_id.
{
  "data": {
    "added": 42
  }
}