Enrichment

Configure Find People

Find contacts at every company on a list. SPENDS CREDITS.

This reads as configuration and is not one. The search runs against the licensed people corpus, and auto_import true imports the results with no review step - so a single call can move thousands of contacts into a list.

max_total_people is the ceiling that matters: it caps the whole run, not each company. max_people_per_company only shapes the distribution.

Found contacts land with their details MASKED. Revealing them costs a further credit per contact.

post/enrichment/find-people/configure

Request

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

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

namestring required
list_idinteger required

Source COMPANY list.

company_identifier_columnstring nullable
max_people_per_companyinteger
max_total_peopleinteger nullable
destination_list_idinteger nullable
create_new_listboolean
new_list_namestring nullable
skip_existing_in_destinationboolean
skip_across_companiesboolean
auto_importboolean

Import results as soon as they are found, with no review step. This is what turns a saved configuration into an immediate run.

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.