Build reusable lists of people or companies, then reference them from People Search, Company Search and Export People with Email to exclude matches — the standard way to skip prospects you already contacted or accounts you want to avoid.

💳 Credit Usage: Free — lists never cost credits.

♻️ Reusable & rewritable: the same list id stays valid across many searches. Update it any time: mode: APPEND (default) adds values; mode: REPLACE rewrites the list with a completely fresh set of values.

You can keep up to 50 lists per day. Each list can hold up to 10,000 items. Lists expire automatically after 24 hours — recreate them daily.

How it works
  • No id → a new list is created (type is required).
  • Your existing id → the list is updated (APPEND merges, REPLACE overwrites).
  • Unknown id → a new list is created for you.

Supported types: people_id, company_id.

🔗 Related Endpoints:
  • People Search — exclude via lists.people_id
  • Company Search — exclude via lists.company_id
  • Export People with Email — suppress contacted people from bulk exports

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