Skip to content

clay.md

Latest commit

 

History

History
149 lines (110 loc) · 3.18 KB

clay.md

File metadata and controls

149 lines (110 loc) · 3.18 KB

Clay

Data enrichment and outbound automation platform for building lead lists with waterfall enrichment across 75+ data providers.

Capabilities

Integration Available Notes
API ✓ Tables, People Enrichment, Company Enrichment
MCP ✓ Claude connector
CLI ✓ clay.js
SDK - REST API only

Authentication

  • Type: API Key (Bearer token)
  • Header: Authorization: Bearer {api_key}
  • Get key: Settings > API at https://app.clay.com

Common Agent Operations

List Tables

GET https://api.clay.com/v3/tables

Authorization: Bearer {api_key}

Get Table Details

GET https://api.clay.com/v3/tables/{table_id}

Authorization: Bearer {api_key}

Get Table Rows

GET https://api.clay.com/v3/tables/{table_id}/rows?page=1&per_page=25

Authorization: Bearer {api_key}

Add Row to Table

POST https://api.clay.com/v3/tables/{table_id}/rows

{
  "first_name": "Jane",
  "last_name": "Doe",
  "company": "Acme Inc",
  "email": "jane@acme.com"
}

People Enrichment

POST https://api.clay.com/v3/people/enrich

{
  "email": "jane@acme.com"
}

Company Enrichment

POST https://api.clay.com/v3/companies/enrich

{
  "domain": "acme.com"
}

Key Metrics

Person Data

  • first_name, last_name - Name
  • email - Email address
  • title - Job title
  • linkedin_url - LinkedIn profile
  • company - Company name
  • location - Location
  • seniority - Seniority level

Company Data

  • name - Company name
  • domain - Website domain
  • industry - Industry
  • employee_count - Number of employees
  • revenue - Estimated revenue
  • location - Headquarters location
  • technologies - Tech stack
  • description - Company description

Table Data

  • id - Table ID
  • name - Table name
  • row_count - Number of rows
  • columns - Column definitions
  • created_at - Creation timestamp
  • updated_at - Last update timestamp

Parameters

Tables

  • page - Page number (default: 1)
  • per_page - Results per page (default: 25)

People Enrichment

  • email - Email address
  • linkedin_url - LinkedIn profile URL
  • first_name + last_name - Name-based lookup

Company Enrichment

  • domain - Company domain (e.g., "acme.com")

Add Row

  • Fields are dynamic and match the table's column definitions
  • Pass data as key-value pairs matching column names

When to Use

  • Building enriched prospect lists with waterfall enrichment across multiple providers
  • Enriching leads with person and company data from 75+ sources
  • Automating outbound workflows with enriched data
  • Finding verified contact info (emails, phone numbers, social profiles)
  • Company research and firmographic analysis
  • Triggering enrichment workflows via webhooks
  • Syncing enriched data back to CRM or outbound tools

Rate Limits

  • Rate limits vary by plan
  • Standard: 100 requests/minute
  • Enterprise plans have higher limits
  • Enrichment credits consumed per lookup vary by data provider
  • Webhook endpoints accept data continuously

Relevant Skills

  • cold-email
  • revops
  • sales-enablement
  • competitors