# How to connect Apollo to AI agents?

Connect Apollo.io to Sequel with an API key and ask about your prospects, contacts, and accounts in natural language.

Connect **Apollo.io** to Sequel and ask about your prospecting and sales data in plain English — search Apollo's B2B database of people and companies, and slice the contacts and accounts your team has saved in Apollo — from the Sequel app or any AI tool wired up to the [MCP server](/docs/install). Apollo connects with a single API key, and Sequel only ever reads.

## What you'll need

- An **Apollo.io account** with access to **Settings → Integrations → API**.
- An **Apollo master API key**. The People and Organization search endpoints require a **master** key (not a scoped key), so create the key with master access enabled.

<Callout type="info" title="Searching Apollo's database consumes credits">
The **Search People** and **Search Organizations** tools query Apollo's global prospect/company database and consume Apollo credits per their pricing. The **Search Contacts** and **Search Accounts** tools read your own saved CRM data and consume no credits.
</Callout>

## Connect it

<Steps>
<Step title="Open a new connection">
In the Sequel dashboard, go to **Connections → New connection** and choose **Apollo.io**.
</Step>

<Step title="Create a master API key in Apollo">
In Apollo, go to **Settings → Integrations → API → Create New Key** and enable **master** access. The key is passed in the `X-Api-Key` header on every request.
</Step>

<Step title="Paste the key into Sequel">
Copy the key from Apollo and paste it into the **API key** field on Sequel's Apollo connector.
</Step>

<Step title="Test and save">
Sequel verifies the key against the Apollo API. A green check means it's live.
</Step>
</Steps>

## What you can query

Sequel exposes Apollo as four read-only search tools:

- **People** — search Apollo's global prospect database by job title, seniority, location, employer, employee-count band, and keywords. (Consumes credits; does **not** return email addresses or phone numbers.)
- **Organizations** — search Apollo's global company database by location, headcount range, industry keyword tags, and domains. (Consumes credits.)
- **Contacts** — search the contacts your team has saved in Apollo (your CRM). No credits consumed.
- **Accounts** — search the accounts (companies) your team has saved in Apollo. No credits consumed.

<Callout type="info" title="Read-only">
The connector ships search tools only — it can't create, update, or delete any Apollo record.
</Callout>

## Try it

- "Find VPs of Sales at SaaS companies in the US with 50-200 employees."
- "Which of our Apollo contacts were added in the last 30 days?"
- "List our accounts in the 'Negotiation' stage, sorted by last activity."
- "Show me companies in the mining industry headquartered in Canada."

## Join it with other sources

Apollo is most useful next to your other data. With a database also connected, ask:

> "Match our Apollo accounts against the customer table in Postgres, and show which prospects aren't customers yet."

## Troubleshooting

| Symptom | Likely fix |
| --- | --- |
| Apollo rejected the API key (`is_logged_in=false`) | Re-check the key for typos, or create a fresh key in **Settings → Integrations → API** and paste it again. |
| People/Organization search errors or returns nothing | The key likely lacks **master** access — those endpoints require it. Recreate the key with master access enabled. |
| A search returns no results | Loosen your filters and confirm there's data in range. For "our" contacts/accounts use the CRM tools; for net-new prospecting use the global search tools. |

## Related

- [Connecting your first data source](/docs/connecting-your-first-data-source)
- [Chatting with your data](/docs/chatting-with-your-data)
- [Browse all integrations](/docs/integrations)