Clay

Connect your AI agents to Clay.

Authentication: API key. See Magic Link for the runtime auth flow.

Sample use cases

Enrich a list of target accounts with headcount and funding data before an outbound campaign.
Search Clay’s people database for VPs of Engineering at companies in your ICP.
Pull rows from the Warm Leads workspace table and sync qualified ones to the CRM.

get_current_user

Get the Clay user and workspace tied to the API key

execute_routine

Run a Clay routine against 1-100 items and get a routine_run_id

get_routine_run

Fetch progress and results for a routine run by routine_run_id

create_batch_upload_url

Issue a presigned PUT URL for uploading a batch input JSONL file for a routine

start_batch_run

Start an async batch routine run over a JSONL file already uploaded via create_batch_upload_url

get_batch_run

Fetch progress and results for a batch run by routine_run_id (from start_batch_run)

list_search_fields

List the filter fields available for a search source_type (‘people’ or ‘companies’), plus Clay’s usage guidance and example filter payloads

create_search

Create a people or company search from structured filters

run_search

Run a search created by create_search and return the next page of matching records

query_tables

Run a structured query across 1-5 Clay tables (Enterprise)