Apollo Automation

Apollo Automation

Supercharge your sales prospecting with Apollo.io -- search companies, discover decision-makers, enrich contact data with emails and phone numbers, and manage your sales pipeline stages -- all through natural language commands.

Toolkit docs: [composio.dev/toolkits/apollo](https://composio.dev/toolkits/apollo)

---

Setup

• Add the Composio MCP server to your client configuration:

   https://rube.app/mcp

• Connect your Apollo.io account when prompted (API key authentication).
• Start issuing natural language commands to prospect and enrich leads.

---

Core Workflows

1. Search Organizations

Find target companies using filters like name, location, employee count, and industry keywords.

Tool: APOLLO_ORGANIZATION_SEARCH

Example prompt: > "Find SaaS companies in Texas with 50-500 employees on Apollo"

Key parameters:

• q_organization_name -- Partial name match (e.g., "Apollo" matches "Apollo Inc.")
• organization_locations -- HQ locations to include (e.g., "texas", "tokyo")
• organization_not_locations -- HQ locations to exclude
• organization_num_employees_ranges -- Employee ranges in "min,max" format (e.g., "50,500")
• q_organization_keyword_tags -- Industry keywords (e.g., "software", "healthcare")
• page / per_page -- Pagination (max 100 per page, max 500 pages)

---

2. Discover People at Companies

Search Apollo's contact database for people matching title, seniority, location, and company criteria.

Tool: APOLLO_PEOPLE_SEARCH

Example prompt: > "Find VPs of Sales at microsoft.com and apollo.io"

Key parameters:

• person_titles -- Job titles (e.g., "VP of Sales", "CTO")
• person_seniorities -- Seniority levels (e.g., "director", "vp", "senior")
• person_locations -- Geographic locations of people
• q_organization_domains -- Company domains (e.g., "apollo.io" -- exclude "www.")
• organization_ids -- Apollo company IDs from Organization Search
• contact_email_status -- Filter by email status: "verified", "unverified", "likely to engage"
• page / per_page -- Pagination (max 100 per page)

---

3. Enrich Individual Contacts

Get comprehensive data (email, phone, LinkedIn, company info) for a single person using their email, LinkedIn URL, or name + company.

Tool: APOLLO_PEOPLE_ENRICHMENT

Example prompt: > "Enrich Tim Zheng at Apollo.io on Apollo"

Key parameters (at least one identifier required):

• email -- Person's email address
• linkedin_url -- Full LinkedIn profile URL
• first_name + last_name + (organization_name or domain) -- Name-based matching
• domain -- Bare hostname without protocol (e.g., "apollo.io", not "https://apollo.io")
• reveal_personal_emails -- Set true to get personal emails (may use extra credits)
• reveal_phone_number -- Set true for phone numbers (requires webhook_url)

---

4. Bulk Enrich Prospects

Enrich up to 10 people simultaneously for efficient batch processing.

Tool: APOLLO_BULK_PEOPLE_ENRICHMENT

Example prompt: > "Bulk enrich these 5 leads with their Apollo data: [list of names/emails]"

Key parameters:

• details (required) -- Array of 1-10 person objects, each with identifiers like email, linkedin_url, first_name, last_name, domain, company_name
• reveal_personal_emails -- Include personal emails (extra credits)
• reveal_phone_number -- Include phone numbers (requires webhook_url)

---

5. Manage Contact Pipeline Stages

List available stages and update contacts through your sales funnel.

Tools: APOLLO_LIST_CONTACT_STAGES, APOLLO_UPDATE_CONTACT_STAGE

Example prompt: > "Move contacts X and Y to the 'Qualified' stage in Apollo"

Key parameters for listing stages: None required.

Key parameters for updating stage:

• contact_ids (required) -- Array of contact IDs to update
• contact_stage_id (required) -- Target stage ID (from List Contact Stages)

---

6. Create and Search Saved Contacts

Create new contact records and search your existing Apollo contact database.

Tools: APOLLO_CREATE_CONTACT, APOLLO_SEARCH_CONTACTS

Example prompt: > "Search my Apollo contacts for anyone at Stripe"

Key parameters for search:

• Keyword search, stage ID filtering, sorting options
• page / per_page -- Pagination

Key parameters for create:

• first_name, last_name, email, organization_name
• account_id -- Link to an organization
• contact_stage_id -- Initial sales stage

---

Known Pitfalls

• Organization domains can be empty: Some organizations from APOLLO_ORGANIZATION_SEARCH return missing or empty domain fields. Use APOLLO_ORGANIZATION_ENRICHMENT to validate domains before relying on them.
• HTTP 403 means config issues: A 403 response indicates API key or plan access problems -- do not retry. Fix your credentials or plan first.
• People search returns obfuscated data: APOLLO_PEOPLE_SEARCH may show has_email/has_direct_phone flags or obfuscated fields instead of full contact details. Use APOLLO_PEOPLE_ENRICHMENT to get complete information.
• Pagination limits are strict: People search supports per_page up to 100 and max 500 pages. Stopping early can miss large portions of the result set.
• Bulk enrichment has small batch limits: APOLLO_BULK_PEOPLE_ENRICHMENT accepts only 10 items per call. It can return status='success' with missing_records > 0 when identifiers are insufficient -- retry individual records with APOLLO_PEOPLE_ENRICHMENT.
• No automatic deduplication: APOLLO_CREATE_CONTACT does not deduplicate. Check for existing contacts first with APOLLO_SEARCH_CONTACTS.
• Domain format matters: Always use bare hostnames (e.g., "apollo.io") without protocol prefixes ("https://") or "www." prefix.

---

Quick Reference

| Action | Tool Slug | Required Params | |---|---|---| | Search organizations | APOLLO_ORGANIZATION_SEARCH | None (optional filters) | | Enrich organization | APOLLO_ORGANIZATION_ENRICHMENT | domain | | Bulk enrich orgs | APOLLO_BULK_ORGANIZATION_ENRICHMENT | domains | | Search people | APOLLO_PEOPLE_SEARCH | None (optional filters) | | Enrich person | APOLLO_PEOPLE_ENRICHMENT | One of: email, linkedin_url, or name+company | | Bulk enrich people | APOLLO_BULK_PEOPLE_ENRICHMENT | details (1-10 person objects) | | List contact stages | APOLLO_LIST_CONTACT_STAGES | None | | Update contact stage | APOLLO_UPDATE_CONTACT_STAGE | contact_ids, contact_stage_id | | Create contact | APOLLO_CREATE_CONTACT | Name + identifiers | | Search contacts | APOLLO_SEARCH_CONTACTS | None (optional filters) |

---

*Powered by [Composio](https://composio.dev)*