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

# Apollo

> Set up and use the Apollo integration with Hyper AI

The Apollo integration lets your agents and workflows search prospects, enrich contacts, and automate outreach.

Auth type: API

<Info>
  For how integrations work overall (permissions, authentication, troubleshooting), see the main guide: [App Integrations](/integrations/overview).
</Info>

## Connect Apollo

1. Go to Settings → Apps in Hyper
2. Select Apollo → Connect New
3. Choose API Key authentication and paste your Apollo key
   * Use your master key or a key with all needed scopes enabled

### Where to find your Apollo API (master) key

1. In the Apollo web app, click your avatar → Settings
2. Open Integrations (or Developer/API, depending on your plan)
3. Select Apollo API → Create API Key (or view existing key)
4. Copy the Master API Key and paste it into Hyper when connecting

Notes:

* You may need admin permissions to view/create the master key
* If your org restricts master keys, create a new key with all required scopes enabled

## Common capabilities

* Find and enrich leads by criteria
* Create and update contacts
* Log activity to support outbound sequences

## Use in Chat

1. In a chat, open the tool selector and enable Apollo
2. Ask your agent to find targets and draft outreach

Example prompt:

```text theme={null}
Find 25 senior product managers at B2B SaaS companies in the US with 50–500 employees. Return a CSV with name, title, company, company size, email (if available), and LinkedIn URL.
```

## Use in Agents

In `Agents → Settings`, add Apollo to the agent’s toolkits and select the connection. Toggle which actions require approval (e.g., “send email”).

## Use in Flows

Add an Apollo action node to search, enrich, or write data, and pass variables from prior steps to parameters.

## Troubleshooting

* Invalid API key: regenerate the key in Apollo and reconnect
* Permission errors: ensure the key has read/write scopes for the requested actions
* Rate limits: reduce batch sizes or add delays in flows

***

## Available Actions

Hyper agents can run the following actions for this integration. Each action can be individually set to **Enabled**, **Requires Approval**, or **Disabled** in your agent's toolkit settings.

Actions can be set to one of three control states:

| State                 | Behavior                                                       |
| --------------------- | -------------------------------------------------------------- |
| **Enabled**           | Agent runs the action automatically                            |
| **Requires Approval** | Agent pauses and waits for your confirmation before proceeding |
| **Disabled**          | Action is blocked and cannot be used                           |

Configure these in the agent's toolkit settings or in workspace defaults.

| Action                    | Description                                                                                                                               |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| Mixed Companies Search    | Search for companies using Apollo API's Organization Search endpoint                                                                      |
| Mixed People Search       | Search for people using Apollo API's People Search endpoint                                                                               |
| Organizations Bulk Enrich | Enrich data for up to 10 companies using Apollo. Do not include '[www](http://www).', @ or similar prefixes in the domains                |
| People Bulk Match         | Batch-enrich up to 10 people, returning current position plus verified work or personal emails when you set reveal\_personal\_emails=True |
| People Match              | Enrich one person's profile and retrieve verified work or personal email                                                                  |