Integration

Apollo + Claude Code Integration via Deepline

Use Apollo's People Match API from a checked Deepline Play. Search the live catalog for Apollo people match, describe the selected contract, and run it against a pilot CSV.

Direct answer

If your query is "Apollo account record company name verification"

The primitive answer is simple: Apollo matching works best when you give Claude Code an explicit person or company key set, then let Deepline send the structured payload to Apollo. For contact matching, the strongest inputs are first_name, last_name, organization_name, domain, and optionally email. For company-oriented verification, the strongest keys are the canonical company name and domain before you ask the agent to enrich downstream CRM or sequencer records.

What this means in practice:

  • If you know the company name and domain, normalize those first, then ask Apollo for the matching person or organization record.
  • If you only have a fuzzy company label, do not treat Apollo as a truth engine by itself. Use the domain and company name together, or route through a Deepline waterfall.
  • If your workflow depends on whether the company record is actually the right account, log the exact input fields and the returned organization fields so the agent can explain why the match was accepted.

Primitives

Match inputs, outputs, and failure cases

PrimitiveWhat Deepline sends or returnsWhy it matters
Primary contact keys`first_name`, `last_name`, `organization_name`, `domain`, optional `email`These are the strongest deterministic keys for Apollo People Match.
Primary company keysCanonical company name plus domainThis reduces false positives when the same account name appears across regions or subsidiaries.
Returned person fieldsEmail, phones, title, seniority, LinkedIn URL, organization fieldsThese are the fields Claude Code can pass into CRM, sequencer, or scoring workflows.
Failure modeNo result, stale result, or weak company matchThis is where Deepline waterfall fallback and explicit review steps matter.
Best follow-up actionValidate, score, or route matched records into HubSpot, Salesforce, Instantly, or SmartleadApollo is usually the lookup step, not the final system of record.

Overview

What This Integration Does

Deepline connects your Apollo account to Claude Code via a native CLI skill. Once connected, Claude Code can enrich contacts via Apollo's People Match endpoint, combine Apollo with other providers in a waterfall, and push results to sequencers, all from slash commands or plain English.

No browser automation. Connect however your agent prefers: the Deepline MCP server for typed tool calls, or the CLI, which Claude Code calls directly the same way it calls git or curl. Both run the same waterfall logic against the same providers.

In Claude Code, ask for Apollo people matching on your CSV. The agent searches and describes the live Play catalog, checks owned source when customization is needed, and runs the selected Play with --watch.

Quick Start

Quick Start

Three steps to enrich contacts with Apollo from Claude Code:

Step 01: Install Deepline CLI

Terminal
npm install -g deepline@latest && npm exec --yes --package=deepline@latest -- deepline setup --json

Step 02: Connect your Apollo API key

Open the Deepline dashboard integrations settings and add your personal Apollo API key.

Step 03: Run your first enrichment

Terminal
deepline tools search "Apollo people match" --json
deepline tools describe apollo_people_match --json

# Claude Code authors a CSV Play from the inspected Apollo contract.

deepline plays check apollo-people-match.play.ts
head -n 4 leads.csv > leads-pilot.csv
deepline plays run --file apollo-people-match.play.ts --csv leads-pilot.csv --watch

Step 04: Inspect the company match fields before writing anywhere else

Terminal
deepline plays run --file apollo-people-match.play.ts --csv leads.csv --run-id-file apollo-match-run.json --watch
RUN_ID=$(jq -er '.runId' apollo-match-run.json)
deepline runs export "$RUN_ID" --dataset result.rows --out apollo-match-review.csv

This gives you a review file before you push anything into Salesforce, HubSpot, or a sequencer. For account-verification use cases, that inspection step is where you confirm the company/domain pair is real before you automate the next action.

Why Deepline

Why Use Deepline vs Calling Apollo's API Directly

You could write custom code to call Apollo's People Match endpoint. Here is why teams use Deepline instead:

AdvantageDetails
Auth, rate limiting, and retry logic handledDeepline manages API key injection, respects Apollo's rate limits, and retries transient failures automatically. No custom error-handling code to maintain.
One CLI command vs custom API integration codeA checked Deepline Play replaces dozens of lines of fetch, parse, and retry logic. The same Play contract works in Claude Code, Codex, or Cursor.
Token-efficient: one tool call, not many API round-tripsClaude Code calls deepline once and gets structured CSV output back. No multi-step MCP tool calls, no JSON parsing in the context window, no wasted tokens on intermediate API responses.
Waterfall fallback built inApollo coverage varies by ICP, region, field, and input quality. Add inspected fallback stages in an owned Play when representative testing shows gaps.

Data Fields

What Apollo Data You Can Access via Deepline

Deepline exposes Apollo's full People Match API. Every data point Apollo returns is available as a column in your output CSV:

FieldDescription
Email addressWork and personal email fields through Apollo People Match
Phone numbersDirect dials and mobile numbers when available
Job title & seniorityCurrent title, seniority level, department, and function
LinkedIn URLProfile URL for each matched contact
Company dataIndustry, employee count, revenue range, tech stack, and funding stage
Email enrichmentValidate and enrich existing email addresses with Apollo's verification

API Details

Apollo People Match Endpoint

Under the hood, Deepline calls Apollo's POST /v1/people/match endpoint. Here is the request structure Deepline constructs from your CSV columns:

Terminal
// Apollo People Match - what Deepline sends per row
POST https://api.apollo.io/v1/people/match
{
"first_name": "Jane",
"last_name": "Doe",
"organization_name": "Acme Corp",
"email": "jane@acme.com" // optional - improves match rate
}

// Response includes:
// email, phone, title, seniority, linkedin_url,
// organization.name, organization.industry,
// organization.estimated_num_employees, ...

You never write this code. Deepline maps your CSV headers to the request fields and flattens the response into CSV columns automatically.

Waterfall

Apollo in a Waterfall

Apollo coverage varies by ICP, region, field, and input quality. If representative testing shows gaps, inspect the current provider contracts and keep the approved fallback order in one owned Play:

Terminal
deepline tools search "Apollo Crustdata PDL work email" --json

# Claude Code authors the fallback order from the inspected live contracts.

deepline plays check apollo-fallback-email.play.ts
deepline plays run --file apollo-fallback-email.play.ts --csv leads.csv --watch

The Play stops when a stage returns an accepted result. Later stages do not execute after that point. Billing still depends on the pricing unit of every stage that ran. Learn more about waterfall enrichment.

For a provider-level reference, see Apollo in the GTM Stack directory, Crustdata in the GTM Stack directory, and the Apollo to Instantly Claude Code workflow.

Natural Language

Using Apollo with Claude Code in Plain English

You don't need to memorize CLI flags. After installing Deepline, just tell Claude Code what you want in plain English. It reads the skill docs and calls the right Deepline commands automatically.

You say: "Enrich these leads with Apollo"

Terminal
deepline tools describe apollo_people_match --json
deepline plays check apollo-people-match.play.ts
deepline plays run --file apollo-people-match.play.ts --csv leads.csv --watch

You say: "Find emails for these companies using Apollo and fall back to PDL"

Terminal
deepline tools search "Apollo PDL work email" --json
deepline plays check apollo-pdl-email.play.ts
deepline plays run --file apollo-pdl-email.play.ts --csv leads.csv --watch

You say: "Enrich this list with Apollo, validate the emails, and score against our ICP"

Terminal
deepline tools search "Apollo email validation ICP scoring" --json
deepline plays check apollo-qualified-leads.play.ts
deepline plays run --file apollo-qualified-leads.play.ts --csv leads.csv --watch

Trusted by GTM teams

+17%
Win rate improvement at Mixmax from AI-prioritized account signals
Months to Days
Series B aerospace company unified 30+ data sources in under one week
8x lift
Enterprise cybersecurity identified 8,200 high-propensity accounts with <10 hours RevOps effort
1How do I use Apollo with Claude Code?+

Install the Deepline CLI, connect your Apollo API key, then search the live Play catalog for Apollo people matching. Describe the selected contract and run it against a pilot CSV with --watch. Deepline handles authentication, rate limiting, retries, and structured output.

2What Apollo data can I access through Claude Code via Deepline?+

You can access Apollo's full People Match API including verified work and personal emails, direct dial and mobile phone numbers, current job title and seniority, LinkedIn URL, and company data like industry, employee count, revenue, and tech stack. All data is returned as structured CSV columns.

3Can I combine Apollo with other enrichment providers in Claude Code?+

Yes. Inspect the current provider contracts. Create an owned Play that declares Apollo as one stage. Continue to the next stage when the result does not meet the acceptance condition. Billing depends on each operation that runs.

4Do I need my own Apollo API key?+

Yes. Deepline uses your own Apollo API key, so you pay Apollo directly at their standard rates. There is no markup or credit system. Connect your key once and it works across all your enrichment commands.

5Is the Apollo + Claude Code integration free?+

Deepline charges no platform fee for BYOK provider requests. Your Apollo contract controls Apollo access and charges. Managed Deepline tools use their published pricing units.

6Why use Deepline instead of Apollo's native Claude connector?+

Claude Code can use Apollo through available API or MCP surfaces. Deepline adds a shell- and SDK-operated Play contract that can compose Apollo with inspected fallback stages, validation, usage, and run status. Choose the interface that fits your agent runtime and provider access.