Apollo.io

​

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 by domain. Required fields:

• Domain: Company domain

Returns: Company firmographics, size, industry, technologies, and more.

​

Search people

Find prospects matching specific criteria. Filters:

• Person titles: Job titles to search for
• Organization domains: Specific company domains
• Person locations: Geographic locations
• Organization locations: Company headquarters locations
• Keywords: Search across all fields
• Person seniorities: owner, founder, c_suite, vp, director, manager, senior, entry, intern
• Contact email status: verified, unverified, likely_to_engage, unavailable
• Organization employee ranges: Company size filters
• Prospected by current team: Filter by team prospecting history

Use case: Build targeted prospect lists based on ICP criteria.

​

Search organizations

Find companies matching specific criteria. Filters:

• Organization name: Company name search
• Keyword tags: Industry and topic tags
• Organization locations: Company locations
• Organization not locations: Exclude locations
• Organization employee ranges: Company size
• Prospected by current team: Filter by prospecting history

​

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

​

Credits

Apollo.io uses a credit-based system:

• Enrich person: 1 credit (3 credits with phone number reveal)
• Enrich organization: 1 credit
• Search actions: No direct credit cost (pagination limits apply)

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.