Skip to main content

Overview

Buckle connects AI agents to Clay with an API key. Agents can search Clay’s GTM database for people and companies, run Clay-managed or custom functions to enrich records, and query Clay tables. The gateway injects the key into requests to api.clay.com, so your agent never sees it.

What you will set up

  • A Clay API key stored in Buckle
  • Automatic key injection on requests to api.clay.com
  • Per-agent, per-tool access, with approval for credit-spending runs

Setup

1

Create an API key in Clay

In Clay, go to Settings > Account > API keys and create a key. Keys are tied to your Clay user and workspace. See Find your Clay API key.
2

Connect in Buckle

Open the Buckle dashboard, go to Settings > Apps > Clay, and paste your key. The connection shows your Clay email and workspace.
Buckle connect dialog for Clay, showing the required API key field, a link on how to find your Clay API key, an Advanced section with an optional connection label, and the Connect Clay button.

The Clay connect dialog in Buckle.

What agents can do

Quick example

No auth header is needed, the gateway adds it:

Disconnecting

  • In Buckle, open Settings > Apps > Clay and remove the connection.
  • In Clay, delete the API key under Settings > Account > 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. Routine runs spend Clay credits, so consider requiring approval for them. Organization rules add guardrails on top, like rate limits. Everything is checked before credential injection, so a blocked request never reaches Clay.

FAQ

Create a new key in Clay under Settings > Account > API keys, then paste it into Settings > Apps > Clay. Agents pick up the new key automatically. Then delete the old key.
Store it in Buckle. The gateway adds it at the proxy, so agents call the API with no auth header. See How it works.
Require approval for routine runs when you grant the connection, and add a rate limit with rules. Agents can check the credit balance first.