People Data Labs: Enrich Contact

Enrich one person from an email, phone, LinkedIn URL, or name plus company with their profile: current job title, company, work history, education,.

Tool ID: peopledatalabs_enrich_contact

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'peopledatalabs_enrich_contact',
  {
    "email": "jane.doe@example.com",
    "phone": "+14155550123",
    "profile": "example"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute peopledatalabs_enrich_contact --input '{
  "email": "jane.doe@example.com",
  "phone": "+14155550123",
  "profile": "example"
}' --json

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "data": {
    "id": "id_123",
    "full_name": "Example",
    "first_name": "Jane"
  }
}

Use deepline describe peopledatalabs_enrich_contact --json for the latest machine-readable contract.

Input reference

People Data Labs person enrichment input for targeted 1:1 matching (single best profile).

Name	Type	Required	Default	Details
`payload.email`	`string`	No	—	Email the person has used.
`payload.phone`	`string`	No	—	Phone number for person matching. PDL expects +[country code] for phone matches.
`payload.profile`	`string`	No	—	Social profile URL the person has used.
`payload.linkedin_url`	`string`	No	—	Compatibility alias for profile. Prefer profile for new PDL calls.
`payload.email_hash`	`string`	No	—	Hashed email identifier.
`payload.lid`	`string`	No	—	PDL LinkedIn ID.
`payload.pdl_id`	`string`	No	—	PDL persistent person ID.
`payload.first_name`	`string`	No	—	Person first name.
`payload.last_name`	`string`	No	—	Person last name.
`payload.middle_name`	`string`	No	—	Person middle name.
`payload.name`	`string`	No	—	Full name (alternative to first_name + last_name).
`payload.company`	`string`	No	—	Company name, website, or social URL where the person has worked.
`payload.domain`	`string`	No	—	Compatibility alias for company when the context is a company domain. Prefer company for new PDL calls.
`payload.company_name`	`string`	No	—	Compatibility alias for company when the context is a company name. Prefer company for new PDL calls.
`payload.school`	`string`	No	—	School name context.
`payload.location`	`string`	No	—	Free-form location string.
`payload.street_address`	`string`	No	—	Street address for matching.
`payload.locality`	`string`	No	—	City/locality.
`payload.region`	`string`	No	—	State/region.
`payload.country`	`string`	No	—	Country.
`payload.postal_code`	`string`	No	—	Postal/ZIP code.
`payload.birth_date`	`string`	No	—	Birth date (if known).
`payload.titlecase`	`boolean`	No	—	Normalize text casing in 200 responses, matching PDL titlecase.
`payload.pretty`	`boolean`	No	—	Pretty-print the upstream PDL response.
`payload.min_likelihood`	`integer`	No	—	Minimum PDL likelihood score required for a 200 match. Deepline defaults to 6 when omitted. PDL native default is 2. Minimum: 0. Maximum: 10.
`payload.include_if_matched`	`boolean`	No	—	Include PDL matched input fields in the top-level response metadata.
`payload.required`	`string`	No	—	PDL required boolean expression over top-level fields, e.g. personal_emails or education AND (emails OR phone_numbers).
`payload.data_include`	`string`	No	—	Comma-separated PDL fields/subfields to include. To request no data payload, pass the literal two-character value "". A bare empty value is ignored and returns the full record.

Output reference

People Data Labs enrich contact result.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.id`	`string`	No	—	—
`result.data.full_name`	`string`	No	—	—
`result.data.first_name`	`string`	No	—	—
`result.data.last_name`	`string`	No	—	—
`result.data.linkedin_url`	`string \| null`	No	—	—
`result.data.work_email`	`string \| null`	No	—	—
`result.data.emails`	`array`	No	—	—
`result.data.personal_emails`	`array`	No	—	—
`result.data.recommended_personal_email`	`string \| null`	No	—	—
`result.data.mobile_phone`	`string \| null`	No	—	—
`result.data.phone_numbers`	`array`	No	—	—
`result.data.job_title`	`string \| null`	No	—	—
`result.data.job_company_name`	`string \| null`	No	—	—
`result.data.location_name`	`string \| null`	No	—	—
`result.meta`	`record`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: per_result (per result).
Estimated Deepline credits: 2.38 per pricing unit.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation