Ai Ark · Contact Data

AI Ark / Create or Update a List

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: peopleid, companyid. 🔗 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.

Private Gateway connection

Data below comes from the configured private Gateway. Provider activation remains governed by its evidence and policy gates.

unverifiedRequest shape unavailableUnverified

Published API evidence

Public metadata only. Response bodies, credentials, and internal review notes are never displayed.

No verification date is claimed. No response capture is claimed.

Request parameters

id body · optional
Existing list id to update. Omit to create a new list.
mode body · optional
<code>APPEND</code> (default) merges the values into the list; <code>REPLACE</code> overwrites it.
type body · optional
<code>people_id</code> or <code>company_id</code>. Required when creating.
values body · required
The IDs to store (person or company ids, matching <code>type</code>). Max <strong>10,000</strong> per list.

Provider docs How to run it