Skip to main content
skill CX Codex

apollo-core-workflow-a — Claude Code skill: what it does, install

apollo-core-workflow-a builds an Apollo.io lead generation pipeline in Claude Code to search prospects and enrich qualified contacts with verified emails and phone numbers.

MIT 1 installs ★ 2,935 updated 2026-10-29

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add jeremylongshore/tons-of-skills-marketplace --skill apollo-core-workflow-a -a claude-code
Open on GitHub

What apollo-core-workflow-a does

This skill sets up a prospecting workflow using official Apollo API endpoints. It separates prospect discovery from enrichment: searches through POST /mixed_people/api_search and POST /mixed_companies/search are free and consume zero credits, returning candidate profiles without direct contact details.

To retrieve verified emails and phone numbers, the workflow routes qualified leads to POST /people/match at one credit per person or batches up to 10 records via POST /people/bulk_match. A built-in scoring function ranks prospects by seniority and profile completeness before triggering paid calls.

Running this integration requires a valid APOLLO_API_KEY environment variable with search and enrichment scopes enabled. The API will reject calls if the key lacks required permissions.

What it helps with

  • search decision makers across specified organization domains
  • enrich prospect profiles with direct phone numbers and email addresses
  • filter target companies by employee count, industry, and revenue
  • batch enrich up to 10 Apollo records in a single API call
  • score prospects prior to enrichment to minimize Apollo credit spend

Example prompts for the agent

  • Search Apollo contacts for VP and director roles at example.com
  • Find leads in Apollo and enrich the top scored candidates with emails
  • Run apollo lead search to filter target companies by revenue and employee headcount

How to install apollo-core-workflow-a

1Skills CLI (Vercel)

npx skills add jeremylongshore/tons-of-skills-marketplace --skill apollo-core-workflow-a -a claude-code

2Manually: put the files in place

~/.claude/skills/apollo-core-workflow-a/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/apollo-core-workflow-a/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about apollo-core-workflow-a

How to install apollo-core-workflow-a in Claude Code?

Run npx skills add jeremylongshore/tons-of-skills-marketplace --skill apollo-core-workflow-a -a claude-code in your terminal.

Does searching for prospects consume Apollo credits?

No, search calls to /mixed_people/api_search and /mixed_companies/search are free. Apollo charges credits only when you call the single or bulk enrichment endpoints.

What prerequisites are required before using this workflow?

You need an active APOLLO_API_KEY environment variable with search and enrichment permissions, along with criteria defining your Ideal Customer Profile.

Source text

SKILL.md · MIT
---
name: apollo-core-workflow-a
description: 'Implement Apollo.io lead search and enrichment workflow.

  Use when building lead generation features, searching for contacts,

  or enriching prospect data from Apollo.

  Trigger with phrases like "apollo lead search", "search apollo contacts",

  "find leads in apollo", "apollo people search", "enrich contacts apollo".

  '
allowed-tools: Read, Write, Edit, Bash(npm:*), Bash(pip:*), Grep
version: 1.13.0
license: MIT
author: Jeremy Longshore <[email protected]>
tags:
- saas
- apollo
- workflow
compatibility: Designed for Claude Code
---
# Apollo Core Workflow A: Lead Search & Enrichment

## Overview

Build the core Apollo.io prospecting pipeline: search for people and organizations, then enrich the best leads. Key distinction — **search is free** (no credits), **enrichment costs credits**. This skill uses the correct endpoints and `x-api-key` header authentication.

## Prerequisites

- Completed `apollo-install-auth` setup
- Valid Apollo API key with search + enrichment permissions
- Understanding of your Ideal Customer Profile (ICP)

## Instructions

### Step 1: Search for People (Free — No Credits)

The People API Search endpoint (`POST /mixed_people/api_search`) searches Apollo's 275M+ database. It does **not** return emails or phone numbers — use enrichment for that.

```typescript
// src/workflows/lead-search.ts
import axios from 'axios';

const client = axios.create({
  baseURL: 'https://api.apollo.io/api/v1',
  headers: { 'Content-Type': 'application/json', 'x-api-key': process.env.APOLLO_API_KEY! },
});

interface PersonSearchParams {
  domains: string[];
  titles?: string[];
  seniorities?: string[];    // "c_suite", "vp", "director", "manager", "senior"
  locations?: string[];       // "United States", "San Francisco, California"
  page?: number;
  perPage?: number;
}

export async function searchPeople(params: PersonSearchParams) {
  const { data } = await client.post('/mixed_people/api_search', {
    q_organization_domains_list: params.domains,
    person_titles: params.titles,
    person_seniorities: params.seniorities,
    person_locations: params.locations,
    include_similar_titles: true,
    page: params.page ?? 1,
    per_page: params.perPage ?? 25,
  });

  return {
    people: data.people,
    total: data.pagination.total_entries,
    totalPages: data.pagination.total_pages,
    page: data.pagination.page,
  };
}
```

### Step 2: Search for Organizations (Free)

```typescript
// src/workflows/org-search.ts
interface OrgSearchParams {
  keywords?: string;
  locations?: string[];
  employeeRanges?: string[];  // ["1,10", "11,50", "51,200", "201,500"]
  industries?: string[];
  revenueRanges?: string[];   // ["0,1000000", "1000000,10000000"]
}

export async function searchOrganizations(params: OrgSearchParams) {
  const { data } = await client.post('/mixed_companies/search', {
    q_organization_keyword_tags: params.keywords ? [params.keywords] : undefined,
    organization_locations: params.locations,
    organization_num_employees_ranges: params.employeeRanges,
    organization_industry_tag_ids: params.industries,
    organization_revenue_ranges: params.revenueRanges,
    page: 1,
    per_page: 25,
  });

  return data.organizations.map((org: any) => ({
    id: org.id,
    name: org.name,
    domain: org.primary_domain,
    industry: org.industry,
    employees: org.estimated_num_employees,
    revenue: org.annual_revenue_printed,
    city: org.city,
    state: org.state,
  }));
}
```

### Step 3: Enrich a Single Person (1 Credit)

```typescript
// src/workflows/enrich.ts
export async function enrichPerson(params: {
  email?: string;
  linkedinUrl?: string;
  firstName?: string;
  lastName?: string;
  domain?: string;
}) {
  const { data } = await client.post('/people/match', {
    email: params.email,
    linkedin_url: params.linkedinUrl,
    first_name: params.firstName,
    last_name: params.lastName,
    organization_domain: params.domain,
    reveal_personal_emails: false,
    reveal_phone_number: true,
  });

  if (!data.person) return null;
  const p = data.person;

  return {
    id: p.id,
    name: p.name,
    title: p.title,
    email: p.email,
    phone: p.phone_numbers?.[0]?.sanitized_number,
    company: p.organization?.name,
    companyDomain: p.organization?.primary_domain,
    linkedinUrl: p.linkedin_url,
    seniority: p.seniority,
    city: p.city,
    state: p.state,
  };
}
```

### Step 4: Bulk Enrich People (Up to 10 per Call)

```typescript
export async function bulkEnrichPeople(details: Array<{
  email?: string;
  linkedin_url?: string;
  first_name?: string;
  last_name?: string;
  organization_domain?: string;
}>) {
  const { data } = await client.post('/people/bulk_match', {
    details,
    reveal_personal_emails: false,
    reveal_phone_number: false,
  });

  return (data.matches ?? []).map((match: any) => ({
    id: match.id,
    name: match.name,
    email: match.email,
    title: match.title,
    company: match.organization?.name,
  }));
}
```

### Step 5: Build a Combined Lead Pipeline

```typescript
export async function buildLeadPipeline(targetDomains: string[]) {
  const leads: any[] = [];

  for (const domain of targetDomains) {
    // Step A: Search for decision-makers (free)
    const { people } = await searchPeople({
      domains: [domain],
      seniorities: ['vp', 'director', 'c_suite'],
    });

    // Step B: Score leads before enriching (save credits)
    const worthEnriching = people.filter((p: any) => scoreLead(p) >= 50);

    // Step C: Bulk enrich top leads (costs credits)
    if (worthEnriching.length > 0) {
      const enriched = await bulkEnrichPeople(
        worthEnriching.map((p: any) => ({
          first_name: p.first_name,
          last_name: p.last_name,
          organization_domain: domain,
        })),
      );
      leads.push(...enriched);
    }
  }

  return leads.sort((a, b) => scoreLead(b) - scoreLead(a));
}

function scoreLead(person: any): number {
  let score = 0;
  if (person.email) score += 30;
  if (person.phone_numbers?.length) score += 20;
  if (['c_suite', 'vp', 'founder', 'owner'].includes(person.seniority)) score += 30;
  else if (['director'].includes(person.seniority)) score += 20;
  if (person.linkedin_url) score += 10;
  if (person.city) score += 10;
  return score;
}
```

## Output

- People search via `POST /mixed_people/api_search` (free, no credits)
- Organization search via `POST /mixed_companies/search` (free)
- Single person enrichment via `POST /people/match` (1 credit)
- Bulk enrichment via `POST /people/bulk_match` (up to 10 per call)
- Lead scoring to minimize credit spend before enriching

## Error Handling

| Error | Cause | Solution |
|-------|-------|----------|
| Empty `people` array | Too narrow criteria | Broaden seniority levels, add `include_similar_titles: true` |
| `null` from enrichment | Person not in Apollo database | Try enriching via LinkedIn URL instead of name+domain |
| 429 Rate Limited | Too many requests/minute | Batch requests with 500ms delays between calls |
| 403 Forbidden | Standard key used for enrichment | Upgrade to master API key in Apollo dashboard |

## Examples

### Quick ICP Search

```typescript
// Find Series B SaaS companies with 50-500 employees
const companies = await searchOrganizations({
  keywords: 'SaaS',
  employeeRanges: ['51,200', '201,500'],
  locations: ['United States'],
});

// Find VPs of Sales at those companies
for (const company of companies.slice(0, 10)) {
  const { people, total } = await searchPeople({
    domains: [company.domain],
    titles: ['VP Sales', 'Head of Sales', 'VP Revenue'],
  });
  console.log(`${company.name} (${company.domain}): ${total} contacts`);
}
```

## Resources

- [People API Search](https://docs.apollo.io/reference/people-api-search)
- [Organization Search](https://docs.apollo.io/reference/organization-search)
- [People Enrichment](https://docs.apollo.io/reference/people-enrichment)
- [Bulk People Enrichment](https://docs.apollo.io/reference/bulk-people-enrichment)
- [Find People Using Filters](https://docs.apollo.io/docs/find-people-using-filters)

## Next Steps

Proceed to `apollo-core-workflow-b` for email sequences and outreach.

© Jeremy Longshore · MIT · jeremylongshore/tons-of-skills-marketplace

Similar skills

All skills for Backend and APIs →

From the same set139

The whole set →
metric-calculator An auto-activating skill for Data Analytics work. It turns on when you mention "metric calculator" or "metric", then helps with SQL, visualization and statistics. CX Codex +1 1installs klingai-usage-analytics klingai-usage-analytics tracks Kling AI video generation runs, errors, and credit spending using JSONL logs. Builds daily summaries and cost projections. CX Codex +1 1installs cursor-usage-analytics cursor-usage-analytics analyzes aggregated Cursor usage across requests, models, spend, and team adoption. Use it to prepare reports and review quota signals. CX Codex +1 1installs customerio-cost-tuning customerio-cost-tuning audits a Customer.io workspace for wasted spend: which profiles inflate the bill, which accounts can go, where duplicate events pile up. CX Codex +1 1installs firecrawl-migration-deep-dive The firecrawl-migration-deep-dive skill guides a move from Puppeteer, Playwright, Cheerio, or another scraper to Firecrawl v2, with checks for parity, policy, spend, and rollback. CX Codex +1 1installs vercel-webhooks-events vercel-webhooks-events — a skill for Claude Code, Codex, Cursor and other platforms that processes Vercel deployment events with HMAC signature verification. CX Codex +1 1installs vercel-reference-architecture vercel-reference-architecture sets up a layered Vercel architecture for Next.js applications. Helps structure edge middleware, serverless API routes, and environment validation. CX Codex +1 1installs vercel-policy-guardrails The vercel-policy-guardrails skill adds Vercel project checks for secret exposure, CI policy violations, Edge Runtime imports, and protected routes. CX Codex +1 1installs

Project sponsors

Companies that keep this analytics open