Create contact
Create a new contact within your organization and add it to the specified audience. Consumes one credit and queues the contact for enrichment.
Create contact › Request Body
audience_idThe audience ID the new contact will be added to.
Optional list of tag names to attach to the contact. Free-text input — names that already exist on your organization are reused, and any new names are created automatically.
Create contact › Responses
Successful Response
The newly created contact.
Create contacts in batch
Create up to 100 contacts in your organization and add them all to the specified audience in a single request. Consumes one credit per contact and queues each contact for enrichment.
Create contacts in batch › Request Body
audience_idThe audience ID that every contact in the batch will be added to.
List of contacts to create. Maximum 100 per request.
Create contacts in batch › Responses
Successful Response
The contacts that were created, in input order.
created_countTotal number of contacts created in this batch.
credits_consumedTotal credits consumed (one per contact created).
Get contact
Retrieve a single contact by its unique identifier. Returns contact details including name, email, phone, LinkedIn URL, and optionally the associated company.
path Parameters
contact_idGet contact › Responses
Successful Response
The contact details.
Search contacts
Search contacts within your organization with optional filters on name, job title, company, location, and LinkedIn URL. Results are paginated.
Search contacts › Request Body
Filter by first name.
Filter by last name.
Filter by email address (searches both work and personal emails).
Filter by job title.
Filter by functional area.
Filter by company name.
Filter by company domain.
Filter by city.
Filter by state or region.
Filter by country.
Filter by postal code.
Filter by LinkedIn profile URL.
pagePage number (1-indexed).
page_sizeNumber of results per page.
Search contacts › Responses
Successful Response
Contacts matching the search criteria.
Get contact work email by LinkedIn URL
Look up the contact's LinkedIn URL against our database and return the work email associated with that profile. The contact record is not modified. Returns null for work_email and source if no match is found in either dataset. Requires the contact to have a linkedin_url set; 400 otherwise.
path Parameters
contact_idGet contact work email by LinkedIn URL › Responses
Successful Response
contact_idThe contact id that was queried.
The work email discovered for the contact's LinkedIn URL, or null if no match was found.
Get contact website visits
Retrieve website visits associated with a specific contact via identity resolution. Optionally filter by audience and resolution outcome (direct, probable, or unresolved).
path Parameters
contact_idGet contact website visits › Request Body
Filter visits to a specific audience.
Filter by identity resolution outcome: direct, probable, or unresolved.
pagePage number (1-indexed).
page_sizeNumber of results per page.
Get contact website visits › Responses
Successful Response
Website visits associated with the contact.
totalTotal number of matching website visits.
pageCurrent page number.
page_sizeNumber of results per page.