View as Markdown
Apollo icon

Apollo ACTION

Enrich Person

Enriches a person's information using Apollo's 270M+ contact database. Pass any combination of name, email, domain, organization, or LinkedIn URL — the more info you provide, the better the match. This action consumes Apollo enrichment credits. Returns detailed profile data including title, company, seniority, phone numbers, and social profiles. Do NOT pass personal social media URLs as the domain — use only company domains like apollo.io. If revealPhoneNumber is true, you must also provide a webhookUrl where Apollo will POST the phone data asynchronously. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Apollo account once, then configure and run Enrich Person from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "apollo_io_oauth-enrich-person",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    apollo_io_oauth: { authProvisionId: "apn_xxxxxxx" },
    firstName: "First Name",
    lastName: "Last Name",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Enrich Person inputs
Property Type Description
firstName First Name string
The person's first name.
Optional
lastName Last Name string
The person's last name.
Optional
name Full Name string
The person's full name. Use this instead of separate first/last name fields if you only have the full name.
Optional
email Email string
The person's email address.
Optional
hashedEmail Hashed Email string
MD5 or SHA-256 hashed email. Example: 8d935115b9ff4489f2d1f9249503cadf (MD5).
Optional
organizationName Organization Name string
The person's company name.
Optional
domain Domain string
The company domain (not a personal URL). Example: apollo.io or microsoft.com. Do NOT include www. or @.
Optional
linkedinUrl LinkedIn URL string
The person's LinkedIn profile URL. Example: https://www.linkedin.com/in/johndoe.
Optional
revealPersonalEmails Reveal Personal Emails boolean
Set to true to include personal email addresses in the enrichment results.
Optional
revealPhoneNumber Reveal Phone Number boolean
Set to true to request phone numbers including mobile. Requires webhookUrl to be set — Apollo delivers phone data asynchronously via webhook.
Optional
webhookUrl Webhook URL string
Required when revealPhoneNumber is true. Apollo will POST a JSON payload with phone data to this URL.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
apollo_io_oauth-enrich-person
Version
0.0.2
App
Apollo
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes