Apollo

Troubleshooting

If requests fail, run zero doctor check-connector --env-name APOLLO_TOKEN or zero doctor check-connector --url https://api.apollo.io/api/v1/mixed_people/api_search --method POST

Authentication

All requests require an API key passed in the header:

x-api-key: $APOLLO_TOKEN

Get your API key from: Apollo dashboard → Settings → Integrations → API → Create API Key.

Note: Adding contacts to sequences requires a Master API Key (not a standard key).

Environment Variables

Key Endpoints

Base URL: https://api.apollo.io

1. Search People

POST /api/v1/mixed_people/api_search

Find people by job title, company, industry, location, etc. Does not return email addresses — use Enrich to get emails.

curl -X POST https://api.apollo.io/api/v1/mixed_people/api_search \
  -H "x-api-key: $APOLLO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "page": 1,
    "per_page": 25,
    "person_titles": ["CEO", "Founder"],
    "person_locations": ["United States"],
    "organization_num_employees_ranges": ["1,50"]
  }'

Key filter parameters:

• person_titles — job titles (array)
• person_locations — cities, states, or countries (array)
• organization_num_employees_ranges — e.g. ["1,50", "51,200"]
• q_keywords — keyword search string

Response includes people array with id, name, title, organization_name, linkedin_url.

2. Search Organizations

POST /api/v1/mixed_companies/search

Find companies by industry, size, location, etc.

curl -X POST https://api.apollo.io/api/v1/mixed_companies/search \
  -H "x-api-key: $APOLLO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "page": 1,
    "per_page": 25,
    "organization_locations": ["San Francisco, CA"],
    "organization_num_employees_ranges": ["1,50"],
    "q_organization_keyword_tags": ["SaaS", "B2B"]
  }'

3. Enrich a Person (get email)

POST /api/v1/people/match

Look up a specific person and retrieve their email. Consumes credits.

curl -X POST https://api.apollo.io/api/v1/people/match \
  -H "x-api-key: $APOLLO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Tim",
    "last_name": "Cook",
    "organization_name": "Apple",
    "reveal_personal_emails": false
  }'

Parameters:

• first_name, last_name, organization_name — used to match the person
• linkedin_url — alternative identifier (preferred when available)
• reveal_personal_emails — set true to include personal emails (uses more credits)

Response includes person.email and full contact details.

4. Bulk Enrich People

POST /api/v1/people/bulk_match

Enrich up to 10 people in one request.

curl -X POST https://api.apollo.io/api/v1/people/bulk_match \
  -H "x-api-key: $APOLLO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "details": [
      {"first_name": "Alice", "last_name": "Smith", "organization_name": "Acme Corp"},
      {"linkedin_url": "https://linkedin.com/in/bob-jones"}
    ]
  }'

Max 10 items per request. Response is matches array, one per input.

5. Add Contacts to a Sequence

POST /api/v1/emailer_campaigns/{sequence_id}/add_contact_ids

Add contacts to an email sequence. Requires Master API Key.

curl -X POST "https://api.apollo.io/api/v1/emailer_campaigns/{SEQUENCE_ID}/add_contact_ids" \
  -H "x-api-key: $APOLLO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_ids": ["CONTACT_ID_1", "CONTACT_ID_2"],
    "emailer_campaign_id": "SEQUENCE_ID",
    "send_email_from_email_account_id": "EMAIL_ACCOUNT_ID"
  }'

To find sequence IDs, use POST /api/v1/emailer_campaigns/search.

Common Workflows

Full Cold Outreach Pipeline

# Step 1: Search for target people
curl -s -X POST https://api.apollo.io/api/v1/mixed_people/api_search \
  -H "x-api-key: $APOLLO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"person_titles": ["VP Sales"], "per_page": 10}'

# Step 2: Enrich to get email
curl -s -X POST https://api.apollo.io/api/v1/people/match \
  -H "x-api-key: $APOLLO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"first_name": "Jane", "last_name": "Doe", "organization_name": "Acme"}'

# Step 3: Add to sequence (requires Master API Key)
curl -s -X POST "https://api.apollo.io/api/v1/emailer_campaigns/$SEQUENCE_ID/add_contact_ids" \
  -H "x-api-key: $APOLLO_TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"contact_ids\": [\"$CONTACT_ID\"], \"emailer_campaign_id\": \"$SEQUENCE_ID\"}"

Find Sequences

curl -X POST https://api.apollo.io/api/v1/emailer_campaigns/search \
  -H "x-api-key: $APOLLO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"per_page": 25}'

Notes

• People Search does not return emails — always follow up with Enrich
• Adding to sequences requires a Master API Key (Settings → Integrations → API → Master Key)
• Bulk enrichment: max 10 records per request
• Contact IDs used in sequences are created automatically when you enrich a person