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

# Apollo.io Integration: Sales Intelligence for Agents

> Agents can search contacts, enrich leads, manage sequences, and work with deals in Apollo.io. OAuth credentials are injected automatically.

## Overview

OneCLI connects AI agents to Apollo.io through OAuth. Agents can search for people and companies, enrich contact data, manage outreach sequences, and work with your sales pipeline. The gateway injects OAuth credentials into requests to the Apollo.io API automatically.

<Note>
  Apollo.io is a cloud-only integration, available on the Team plan.
</Note>

## Setup

<Steps>
  <Step title="Go to Connections">
    Open the OneCLI dashboard and navigate to **Connections** > **Apollo.io**.
  </Step>

  <Step title="Authorize">
    Click **Connect Apollo.io**. You'll be redirected to Apollo.io to authorize OneCLI. Review the requested permissions and click **Authorize**.

    Your Apollo.io account must have the "Can authorize third-party apps/integrations via OAuth" permission, or an Admin or Billing role.
  </Step>

  <Step title="Verify">
    After authorization, you'll be redirected back to the dashboard. The connection will show as **Connected** with your Apollo.io email.
  </Step>
</Steps>

## What agents can do

| Area               | Description                                                            |
| ------------------ | ---------------------------------------------------------------------- |
| **People search**  | Search for people by name, title, company, location, and other filters |
| **Company search** | Search for organizations by name, domain, industry, and size           |
| **Enrichment**     | Enrich contact and company records with Apollo.io data                 |
| **Contacts**       | Read, create, and update contact records in your CRM                   |
| **Accounts**       | Read, create, and update account (company) records                     |
| **Deals**          | Read, create, and update opportunities and pipeline stages             |
| **Sequences**      | View and manage outreach sequences and enrollments                     |
| **Tasks**          | Read, create, and manage sales tasks                                   |
| **Email accounts** | View connected email accounts                                          |

## Quick example

An agent calling the Apollo.io API through the gateway:

```bash theme={null}
# Search for people at a company
curl -s -X POST "https://api.apollo.io/api/v1/mixed_people/search" \
  -H "Content-Type: application/json" \
  -d '{"organization_domains": ["example.com"], "page": 1, "per_page": 10}'

# Enrich a person by email
curl -s -X POST "https://api.apollo.io/api/v1/people/match" \
  -H "Content-Type: application/json" \
  -d '{"email": "jane@example.com"}'

# Search for companies
curl -s -X POST "https://api.apollo.io/api/v1/mixed_companies/search" \
  -H "Content-Type: application/json" \
  -d '{"organization_num_employees_ranges": ["1,100"], "page": 1}'
```

The agent makes standard Apollo.io API calls. The gateway injects the authentication automatically.

## Use cases

* Lead research agents that find and enrich prospect data before outreach
* Sales pipeline agents that create and update deals as conversations progress
* Prospecting agents that search for contacts matching an ideal customer profile
* Outreach agents that manage sequences and track engagement
* Data enrichment agents that keep CRM records up to date with fresh contact info

## Controlling access with rules

Use OneCLI's [rules engine](/guides/rules) to control what agents can do with your Apollo.io account. For example, allow agents to search and enrich contacts but block creating sequences, or restrict write operations entirely. Rules are evaluated before credential injection, so a blocked request never reaches the Apollo.io API.