Build reusable lists of people or companies, then reference them from People Search and Company Search to exclude matches — handy for skipping prospects you already contacted or accounts you want to avoid.

You can keep up to 50 lists per day. Each list can grow up to 10,000 items by appending more values, or you can replace it with a fresh set, so the same list stays useful across many searches during the day. Lists expire automatically after 24 hours.

How it works
  • No id → a new list is created (type is required).
  • Your existing id → the list is updated. Use mode: APPEND (default, adds values) or REPLACE (overwrites values).
  • Unknown id → a new list is created for you.

Supported types: people_id, company_id.

The header Content-Type: application/json must be included in the request.