> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getcargo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Apollo.io

> Connect Apollo.io to enrich contacts, search prospects, and manage sales engagement in your workflows.

## 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.