Skip to main content

​
Overview

OneCLI 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.

​
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 OneCLI

Open the OneCLI dashboard, go to Connections > Clay, and paste your key. The connection shows your Clay email and workspace.

​
What agents can do

​
Quick example

No auth header is needed, the gateway adds it:

​
Disconnecting

  • In OneCLI, open Connections > 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.