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

# Apollo.io

> Search and enrich people, companies, and contacts in Apollo.io

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: API key.
* **Connection**: The key from `APOLLO_API_KEY` is sent as the `X-Api-Key` header.
* **Docs**: [https://docs.apollo.io/reference/authentication](https://docs.apollo.io/reference/authentication)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

| Variable         | Required | Description                                                                                          |
| ---------------- | -------- | ---------------------------------------------------------------------------------------------------- |
| `APOLLO_API_KEY` | Yes      | Apollo.io API key (sent as the X-Api-Key header) [Docs](https://docs.apollo.io/docs/create-api-key). |

## Setup

1. **Create an API key**: In Apollo, go to Settings → Integrations → API ([https://app.apollo.io/#/settings/integrations/api](https://app.apollo.io/#/settings/integrations/api)) and click Create new key. Select the endpoints the key may access, or toggle 'Set as master key' for full access (some endpoints, like listing users, require a master key).
2. **Check your plan's API access**: API access and hourly/daily rate limits depend on your Apollo plan; free accounts have limited API quotas. Search endpoints are free to call, but enrichment and organization search consume Apollo credits.
3. **Set the environment variable**: Add APOLLO\_API\_KEY to your .env.
4. **Verify access**: Run the Search People tool with a simple keyword query.

* The API key is sent in the X-Api-Key header; since September 2024 Apollo no longer accepts keys in query or body parameters
* Enrich Person, Enrich Organization, and Search Organizations consume Apollo credits
* Email addresses in search results may be locked unless your plan/credits allow revealing them

Provider API reference: [https://docs.apollo.io/reference/authentication](https://docs.apollo.io/reference/authentication)

## Tools

| Tool                 | Access | Description                                                                                |
| -------------------- | ------ | ------------------------------------------------------------------------------------------ |
| Search People        | Read   | Search the Apollo database for people by keywords, titles, and locations                   |
| Search Organizations | Write  | Search the Apollo database for companies; consumes Apollo credits                          |
| Enrich Person        | Write  | Enrich a person's profile by name, email, domain, or LinkedIn URL; consumes Apollo credits |
| Enrich Organization  | Write  | Enrich a company profile from its domain; consumes Apollo credits                          |
| Search Contacts      | Read   | Search contacts already saved to your Apollo account                                       |
| Create Contact       | Write  | Create a new contact in your Apollo account                                                |
| Update Contact       | Write  | Update an existing contact in your Apollo account                                          |

## Example prompts

* Search Apollo for heads of sales at SaaS companies in the US and list their names, titles, and companies.
* Enrich this person in Apollo using their email address and summarize their role and company.