Enrichment

Search Import Find People

Import people straight into a list. SPENDS CREDITS.

Two modes, and they differ enormously in blast radius:

  • contacts - import exactly the records you pass. Bounded by your body.
  • icp_filters - import EVERYTHING the filters match, up to max_result. Unbounded unless you set that ceiling.

Use icp_filters with max_result set, always. Without it the run is limited only by how many people match, which is not a number you know before you pay for it.

post/enrichment/find-people/search-import

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/enrichment/find-people/search-import
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

contactsobject[] nullable

Contacts to import directly.

icp_filtersobject[] nullable

Import EVERYTHING these filters match, up to max_result. The unbounded form of this operation.

max_resultinteger nullable
max_employees_per_companyinteger nullable
destination_list_idinteger required
source_list_idinteger required

Response

Successful Response

dataEnrichmentPayload required

One enrichment object, open-shaped.

Open on purpose: a workbench column set is defined by the CUSTOMER at runtime, and the enrichment result shapes grow with every provider added. Pinning them would drop whatever a provider returned that this contract had not caught up on, which on an enrichment surface is the data the customer paid for.

Changes

No recorded changes to this operation across all 2 revisions of this API.