Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
| 1 | ## How do I connect Apollo with an API key? |
| 2 | |
| 3 | Apollo uses API key authentication. There's no OAuth flow and no scopes; Apollo enforces access based on your plan and the key's settings. |
| 4 | |
| 5 | ### Create the Apollo API key |
| 6 | |
| 7 | 1. Sign in to [Apollo](https://app.apollo.io/) with an account that has admin access. |
| 8 | 2. Go to **Admin Settings** > **Integrations**, then open **API** > **API Keys**. |
| 9 | |
| 10 |  |
| 11 | |
| 12 |  |
| 13 | 3. Click **Create a new key** and give it a name. |
| 14 | 4. Turn on **Set as master key** so the key can reach every endpoint Composio's tools call. |
| 15 | 5. Copy the key and store it somewhere safe. You may not be able to view it again. |
| 16 | |
| 17 | ### Create the auth config in Composio |
| 18 | |
| 19 | 1. In the Composio dashboard, go to **Auth Configs**, click **Create Auth Config**, and select **Apollo**. |
| 20 | |
| 21 |  |
| 22 | |
| 23 |  |
| 24 | 2. Make sure the authentication type is **API Key**, then create the auth config. |
| 25 | |
| 26 |  |
| 27 | 3. Click **Connect Account**, paste your Apollo API key, and click **Connect Account**. |
| 28 | |
| 29 |  |
| 30 | 4. Confirm the account shows as **Active**. To test it, run a search tool such as `APOLLO_ORGANIZATION_SEARCH` from the playground. |
| 31 | |
| 32 | See [Custom auth configs](/docs/auth-configuration/custom-auth-configs) for the general flow. |
| 33 | |
| 34 | ## Why can Apollo search or enrichment tools return HTTP 403? |
| 35 | |
| 36 | Apollo API keys can be limited to specific endpoint groups. A tool can return HTTP 403 or `Forbidden` when the underlying Apollo API rejects the key for that operation, even if the same key works for other Apollo tools. |
| 37 | |
| 38 | This can affect gated search, enrichment, usage, and outreach tools such as `APOLLO_PEOPLE_SEARCH`, `APOLLO_ORGANIZATION_SEARCH`, `APOLLO_SEARCH_ACCOUNTS`, `APOLLO_SEARCH_OUTREACH_EMAILS`, `APOLLO_PEOPLE_ENRICHMENT`, `APOLLO_BULK_PEOPLE_ENRICHMENT`, `APOLLO_ORGANIZATION_ENRICHMENT`, `APOLLO_BULK_ORGANIZATION_ENRICHMENT`, and `APOLLO_VIEW_API_USAGE_STATS`. |
| 39 | |
| 40 | In Apollo, make sure the API key has access to the relevant endpoint group or has **Set as master key** turned on. If the Apollo plan does not include the requested API feature, the tool can still return 403 until that access is enabled in Apollo. |