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)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "apollo_io_oauth-enrich-person",
"configured_props": {
"apollo_io_oauth": { "authProvisionId": "apn_xxxxxxx" },
"firstName": "First Name",
"lastName": "Last Name"
}
}'// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "apollo_io_oauth",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
name: "apollo_io_oauth-enrich-person",
arguments: {
firstName: "First Name",
lastName: "Last Name",
},
})SCHEMA
Inputs
Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.
| 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
- Source
- View on GitHub ↗