Skip to main content

Overview

Buckle connects AI agents to Apollo.io with an API key. Agents can search Apollo’s people and company database, enrich records, and manage contacts, accounts, deals, tasks, and sequences. The gateway injects the key into requests to api.apollo.io, so your agent never sees it.

What you will set up

  • An Apollo.io API key, limited to the endpoints your agents need
  • Automatic key injection on requests to api.apollo.io
  • Per-agent, per-tool access, such as approval before sequence enrollment

Setup

1

Create an API key in Apollo

In Apollo, go to Settings > Integrations > API keys and create a key. Select only the endpoints your agents need, or turn on Set as master key for full access. See Apollo’s guide: Create API keys.
2

Connect in Buckle

Open Settings > Apps > Apollo.io, paste your key, and click Connect Apollo.io. Under Advanced you can add an optional connection label to tell multiple Apollo accounts apart.
Buckle connect dialog for Apollo.io, showing the required API key field, a link on how to create an Apollo API key, an Advanced section with an optional connection label, and the Connect Apollo.io button.

The Apollo.io connect dialog in Buckle.

What agents can do

What a connection can actually reach follows the API key: endpoints you left out when creating the key return permission errors, regardless of what Buckle allows.

Quick example

An agent calling the Apollo API through the gateway. No auth header is needed, the gateway adds it:

Disconnecting

  • In Buckle, open Settings > Apps > Apollo.io and remove the connection.
  • Then delete the key in Apollo under Settings > Integrations > API keys.

Controlling access

Access is per agent: grant the connection to each agent that needs it, choosing per tool what runs freely, what needs human approval, and what stays blocked. For example, allow people search but require approval before an agent enrolls contacts in a sequence. Organization rules add guardrails on top, like rate limits. Everything is checked before credential injection, so a blocked request never reaches Apollo.

FAQ

Create a new key in Apollo under Settings > Integrations > API keys, then paste it into Settings > Apps > Apollo.io. Agents pick up the new key automatically. Then delete the old key in Apollo.
Store it in Buckle. The gateway adds it at the proxy, so agents call the API with no auth header and never see the key. See How it works.
The connection can only reach the endpoints you selected when creating the key. Create a key that includes that endpoint, or turn on Set as master key.
Yes. Enrichment uses Apollo credits, so set it to need approval when you grant the connection, or add a rate limit with rules.