Skip to main content
PUT
/
v2
/
lists
/
{listId}
/
results
{
    "items": [
        { "countryCode": "BE", "companyId": "1778186251" }
    ]
}

{
    "success": true,
    "failed": [],
    "message": "Successfully added 1 item(s) to the list."
}
Adds items to a list. The shape of each item in the items array must match the list’s objectType. Sending the wrong shape (e.g. a contact item to a company list) returns 400. You can add up to 100 items per request.

​
Request

​
Path

​
listId
string
required
Obfuscated listId returned by the overview endpoint.

​
Body

​
items
object[]
required
Up to 100 items to add. The item shape depends on the list’s objectType:
  • COMPANY — { "countryCode": "BE", "companyId": "1778186251" }
  • LEGAL_ENTITY — { "legalEntityId": "998877", "countryCode": "BE" } (countryCode is optional)
  • CONTACT — { "company": { "countryCode": "BE", "companyId": "1778186251" }, "identifier": { "contactId": "123456" } }
{
    "items": [
        { "countryCode": "BE", "companyId": "1778186251" }
    ]
}

​
Response

​
success
boolean
true when at least one item was added successfully.
​
failed
object[]
Items that could not be added, each with the original item and a message explaining why (e.g. Company not found, Invalid contactId).
{
    "success": true,
    "failed": [],
    "message": "Successfully added 1 item(s) to the list."
}