Import an AI Finder preview
What it does. Takes a cached previewId and starts the provider-specific import workflow into a destination list. This is the final step for new-list building after you create or identify the destination list. Returns an actionsId you can use to monitor progress.
When to use. Call this as the final step of the preview → iterate → import flow, once you’re happy with the filters. The preview must still be valid (24h TTL).
Preconditions.
listIdmust be a list owned by this client.- The list type must match the preview’s entity: pass a contact list for CONTACT-typed previews (
LINKEDINcontacts,CRM_CONTACTS,CRUNCHBASE_CONTACTS,CRUNCHBASE_INVESTORS), and a company list for COMPANY-typed previews (LINKEDINcompanies,CRM_COMPANIES,CRUNCHBASE_COMPANIES,STORELEADS,THEIRSTACK_TECHNOLOGY,THEIRSTACK_JOBS,GOOGLE_MAPS). Mismatch returns 422. maxCountis an integer between 100 and 2500 in increments of 100.
What you get back. An actionsId — use it with:
GET /v1/actions/{actionsId}/statusto poll progress.- The
actionsIdfilter on/v1/contactsand/v1/companiesto fetch the imported records once they land.
The preview is NOT evicted after import — you can re-import the same preview into a different list until its 24h TTL expires.
Related tool. If you don’t have a previewId yet (you haven’t called the preview or iterate endpoints), use POST /v1/ai-finder/import instead — it runs a brand-new search and import in one step, but any refinements you’d otherwise apply via iterate are not available since there’s no preview to refine.
Required scope:
ACTIONS_WRITERate limit: 10 requests per minute
Authorizations
Path Parameters
The previewId returned by a prior preview or iterate call.
Body
Destination list ID. Must be owned by this client. The list type must match the preview's entity — pass a contact list when the preview's entity is CONTACT, or a company list when it is COMPANY. Mismatch returns 422. Create a list first via POST /v1/lists if needed.
Maximum number of results to import into the destination list. Integer between 100 and 2500, in increments of 100 (100, 200, 300, …, 2500). The actual count may be lower if the search yields fewer matches.
100 <= x <= 2500