Apollo: Enrich Person

Match one person from their email, LinkedIn URL, or name and company, and get their profile and work email.

Tool ID: apollo_enrich_person

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(
  'apollo_enrich_person',
  {
    "name": "Example",
    "email": "jane.doe@example.com",
    "hashed_email": "0123456789abcdef0123456789abcdef"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute apollo_enrich_person --input '{
  "name": "Example",
  "email": "jane.doe@example.com",
  "hashed_email": "0123456789abcdef0123456789abcdef"
}' --json

Example response

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

{
  "data": {
    "person": {
      "id": "id_123",
      "first_name": "Jane",
      "last_name": "Doe"
    }
  }
}

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

Input reference

Apollo people match input. Supports id-assisted matching, but id-only lookup belongs in apollo_bulk_people_enrichment. reveal_personal_emails defaults to true. Phone and waterfall enrichment require webhook_url or poll_only: true.

Name	Type	Required	Default	Details
`payload.name`	`string`	No	—	Person’s full name.
`payload.email`	`string`	No	—	Person’s email address.
`payload.hashed_email`	`string`	No	—	Person’s MD5-hashed email address.
`payload.first_name`	`string`	No	—	Person’s first name.
`payload.last_name`	`string`	No	—	Person’s last name.
`payload.linkedin_url`	`string`	No	—	Person’s LinkedIn profile URL.
`payload.domain`	`string`	No	—	Company domain (e.g., ‘apollo.io’).
`payload.organization_name`	`string`	No	—	Employer/company name.
`payload.id`	`string`	No	—	Apollo person ID from a prior lookup. `apollo_people_match` requires another identifier with `id`. Use `apollo_bulk_people_enrichment` with `details: [{ id }]` for id-only lookup.
`payload.reveal_personal_emails`	`boolean`	No	`true`	When true, attempt personal email reveal (credit-consuming). WARNING: Apollo primarily returns work emails even with this flag (~70% work, ~30% personal). Do NOT use Apollo for personal email discovery - use Fullenrich or BetterContact instead.
`payload.reveal_phone_number`	`boolean`	No	`false`	Request available phone numbers, including mobile, asynchronously. Set poll_only: true and poll apollo_poll_webhook_result with the returned request_id, or supply webhook_url. Phone results may take several minutes and are not included in the initial response.
`payload.run_waterfall_email`	`boolean`	No	—	When true, run waterfall email enrichment. Requires webhook_url or poll_only: true.
`payload.run_waterfall_phone`	`boolean`	No	—	When true, run waterfall phone enrichment. Requires webhook_url or poll_only: true.
`payload.poll_only`	`boolean`	No	—	Receive asynchronous phone or waterfall results by polling apollo_poll_webhook_result with the returned request_id. When true, omit webhook_url.
`payload.webhook_url`	`string`	No	—	Your endpoint for asynchronous phone or waterfall results. Omit when poll_only is true. Deepline does not receive this callback.

Output reference

Legacy alias for Apollo people match result.

Name	Type	Required	Default	Details
`result.data`	`object \| null`	Yes	—	Apollo people match payload with a top-level `person` object.
`result.data.person`	`object`	Yes	—	—
`result.data.person.id`	`string`	No	—	—
`result.data.person.first_name`	`string`	No	—	—
`result.data.person.last_name`	`string`	No	—	—
`result.data.person.name`	`string`	No	—	—
`result.data.person.email`	`string`	No	—	—
`result.data.person.email_status`	`string`	No	—	—
`result.data.person.linkedin_url`	`string`	No	—	—
`result.data.person.title`	`string`	No	—	—
`result.data.person.organization`	`object`	No	—	—
`result.data.person.organization.id`	`string`	No	—	—
`result.data.person.organization.name`	`string`	No	—	—
`result.data.person.organization.primary_domain`	`string`	No	—	—
`result.data.person.organization_id`	`string`	No	—	—
`result.data.request_id`	`string \| number`	No	—	Asynchronous enrichment request ID. Preserve it unchanged and pass it to apollo_poll_webhook_result. IDs outside JavaScript safe integer precision are returned as exact strings.
`result.data.request_id_exact`	`string`	No	—	Exact decimal request ID retained before numeric parsing. Pass this string as request_id to apollo_poll_webhook_result.
`result.data.waterfall`	`object`	No	—	—
`result.data.waterfall.status`	`string`	No	—	—
`result.data.waterfall.message`	`string`	No	—	—
`result.data.waterfall.unprocessed_attributes`	`array`	No	—	—
`result.meta`	`record`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: per_result (per result).
Estimated Deepline credits: 0.17 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