Skip to main content

​
How to set up Apollo.io

​
Authentication

Apollo.io uses API key authentication:
  1. Log in to your Apollo.io account
  2. Navigate to Settings → Integrations → API Keys
  3. Create a new API key or use an existing one
  4. Copy the API key and paste it in Cargo when connecting

​
Apollo.io actions

​
Enrich person

Get detailed information about a person including email and phone. Optional fields:
  • ID: Apollo person ID
  • First name: Person’s first name
  • Last name: Person’s last name
  • Organization name: Company name
  • Email: Known email address
  • Email MD5/SHA256: Hashed email for matching
  • Domain: Company domain
  • LinkedIn URL: Person’s LinkedIn profile URL
  • Reveal personal emails: Include personal email addresses
  • Reveal phone number: Include phone numbers (uses additional credits)
Use cases:
  • Enrich inbound leads with contact details
  • Find email addresses for outbound prospects
  • Verify and update contact information

​
Enrich organization

Get company information. Provide at least one of the identifiers below; Apollo matches on whichever you supply. Fields:
  • Domain: Company domain, without www. or the @ symbol
  • LinkedIn URL: Company LinkedIn page
  • Name: Company name
  • Website: Full website URL
Returns: Company firmographics, size, industry, technologies, and more.

​
Search people

Find prospects matching specific criteria. Person filters:
  • Person titles: Job titles to search for
  • Include similar titles: Also match titles Apollo considers similar; turn off to match your list exactly
  • Person seniorities: owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern
  • Person locations: Geographic locations
  • Contact email status: verified, unverified, likely_to_engage, unavailable
  • Keywords: Search across all fields
  • Prospected by current team: Filter by team prospecting history
Employer filters:
  • Organization domains: Specific company domains
  • Organization IDs: Apollo company IDs
  • Organization locations: Company headquarters locations
  • Organization employee ranges: Company size filters
  • Organization revenue range: Minimum and maximum annual revenue
  • Technologies: Match employers using any of, all of, or none of a set of Apollo technology UIDs
  • Hiring signals: Job titles being recruited for, job locations, number of open postings, and when they were posted
Enrichment: Apollo’s people search returns obfuscated previews with no email. Enable Should enrich to resolve every match into a full profile, which consumes Apollo credits. Use case: Build targeted prospect lists based on ICP criteria.

​
Search organizations

Find companies matching specific criteria. Filters:
  • Organization name: Company name search
  • Organization domains: Specific company domains
  • Organization IDs: Apollo company IDs
  • Keyword tags: Industry and topic tags
  • Organization locations: Company locations
  • Excluded organization locations: Exclude locations
  • Organization employee ranges: Company size
  • Revenue range: Minimum and maximum annual revenue
  • Funding: Latest round amount, total raised, and latest round date
  • Technologies: Companies currently using any of a set of Apollo technology UIDs
  • Hiring signals: Job titles being recruited for, job locations, number of open postings, and when they were posted

​
Search contacts

Search your existing Apollo contacts. Filters:
  • Contact stages: Filter by pipeline stage
  • Keywords: Search across contact fields
  • Sort by field: Order results by activity date, email opens, clicks, created/updated dates
  • Sort ascending: Sort direction

​
Search email accounts

List email accounts available for sequences. Optional fields:
  • User ID: Filter by specific user

​
Create contact

Add a new contact to your Apollo database. Required fields:
  • Email: Contact’s email address
Optional fields:
  • Contact stage: Pipeline stage
  • Owner: Assign to a user
  • Mappings: Standard fields (first name, last name, title, phone numbers, etc.)
  • Custom mappings: Custom field values

​
Upsert contact

Create a new contact or update existing (matched by email). Same fields as Create contact. Prevents duplicates when syncing from external sources.

​
Update contact

Update an existing contact by ID. Required fields:
  • ID: Apollo contact ID
Optional fields:
  • Same as Create contact

​
Add contact to sequence

Enroll a contact in an email sequence. Required fields:
  • Contact ID: The Apollo contact ID
  • Sequence ID: Select the sequence
  • Email account ID: The email account to send from
Optional fields:
  • Options: Additional enrollment options
  • User ID: Assign to specific user
Use case: Automatically enroll qualified leads in outreach sequences.

​
Remove contact from sequence

Remove a contact from an active sequence. Required fields:
  • Contact ID: The Apollo contact ID
  • Sequence ID: The sequence to remove from
  • Mode: Choose action:
    • Mark as finished
    • Remove
    • Stop

​
Apollo.io data models

​
Fetch contacts

Pull contacts from Apollo.io into Cargo. Configuration:
  • Contact stages: Filter by specific stages
Features:
  • Incremental sync (only new/updated contacts)
  • Minimum 30-minute sync interval
  • Unifies by LinkedIn URL, LinkedIn UID, or email

​
Fetch accounts

Pull accounts from Apollo.io into Cargo. Configuration:
  • Account stages: Filter by specific stages
Features:
  • Incremental sync
  • Minimum 30-minute sync interval
  • Unifies by domain or LinkedIn URL

​
Fetch people

Build a contact model from Apollo’s people database rather than from your own Apollo CRM. Configuration:
  • The same person, employer, technology, and hiring filters as the Search people action
  • Limit: defaults to 500, up to 50,000
Features:
  • Stores Apollo’s search results as they come back. These are partial previews — no email, LinkedIn URL, or full last name — so run the stored rows through the Enrich person action to resolve them into full profiles.
  • Works with Cargo credits or your own API key, with no credit cost either way: Apollo’s people search is free.

​
Fetch organizations

Build an account model from Apollo’s company database rather than from your own Apollo CRM. Configuration:
  • The same firmographic, funding, technology, and hiring filters as the Search organizations action
  • Limit: defaults to 500, up to 50,000
Features:
  • Unifies by domain or LinkedIn URL
  • Returns both companies new to you and companies you already track as Apollo accounts. Apollo splits these across two buckets internally; both are stored, with accounts mapped onto the organization shape.
  • Works with Cargo credits or your own API key. Apollo charges 1 of its credits per page of up to 100 organization search results, so on Cargo credits each record costs 0.01 credits.
Firmographics that Apollo only hydrates on the search side — industry, revenue, funding — come back empty for companies already saved as accounts in your Apollo CRM. Run Enrich organization on those rows to fill them in.
Apollo stops serving search results past 50,000 records however the query is paginated. Narrow your filters rather than raising the limit if you need deeper coverage.

​
Credits

Apollo.io is billable with Cargo credits, so you can use it without your own Apollo account. One Apollo credit converts to one Cargo credit.
  • Enrich person: 1 credit (9 credits with phone number reveal, which costs Apollo 8 extra credits)
  • Enrich organization: 1 credit
  • Search people: free on its own; enabling Should enrich costs 1 credit per enriched result
  • Search organizations: 0.01 credits per result, since Apollo charges 1 of its credits per page of up to 100 organization search results
  • Fetch people: no credit cost — it stores unenriched search previews
  • Fetch organizations: 0.01 credits per record
Cargo tracks credit usage and supports caching to optimize costs.

​
Rate limits

Apollo.io API has a rate limit of 400 requests per hour. Cargo automatically handles rate limiting with retry logic to ensure reliable execution.