At a glance
- Availability: Experimental (how to enable).
- Auth: API key.
- Connection: The key from
APOLLO_API_KEYis sent as theX-Api-Keyheader. - Docs: https://docs.apollo.io/reference/authentication
Credentials
Set these per environment. See Connect an integration.| Variable | Required | Description |
|---|---|---|
APOLLO_API_KEY | Yes | Apollo.io API key (sent as the X-Api-Key header) Docs. |
Setup
- Create an API key: In Apollo, go to 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).
- 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.
- Set the environment variable: Add APOLLO_API_KEY to your .env.
- 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
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.