| name | clay-install-auth |
| description | Set up Clay account access, API keys, webhook URLs, and provider connections.
Use when onboarding to Clay, connecting data providers, configuring API keys,
or setting up webhook endpoints for programmatic data flow.
Trigger with phrases like "install clay", "setup clay", "clay auth",
"configure clay API key", "connect clay providers".
|
| allowed-tools | Read, Write, Edit, Bash(curl:*), Bash(npm:*), Grep |
| version | 1.14.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| tags | ["saas","clay","api","authentication"] |
| compatibility | Designed for Claude Code, also compatible with Codex and OpenClaw |
Clay Install & Auth
Overview
Clay is a web-based data enrichment platform — there is no SDK to install. Integration happens through webhook URLs (inbound data), HTTP API enrichment columns (outbound calls from Clay), and the Enterprise API (programmatic people/company lookups). This skill covers account setup, API key management, provider connections, and webhook configuration.
Prerequisites
- Clay account at clay.com (free tier available)
- For Enterprise API: Enterprise plan subscription
- For webhook integration: HTTPS endpoint or tunneling tool (ngrok)
Instructions
Step 1: Get Your Clay API Key (Enterprise Only)
Navigate to Settings > API in your Clay workspace. Copy your API key. Clay's Enterprise API is limited to people and company data lookups — it is not a general-purpose table API.
export CLAY_API_KEY="clay_ent_your_api_key_here"
curl -s -X POST "https://api.clay.com/v1/people/enrich" \
-H "Authorization: Bearer $CLAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email": "test@example.com"}' | jq .
Step 2: Configure Webhook Inbound Source
Every Clay table can receive data via a unique webhook URL. This is the primary way to send data into Clay programmatically.
- Open a Clay workbook (or create one)
- Click + Add at the bottom of the table
- Search for Webhooks and click Monitor webhook
- Copy the generated webhook URL
export CLAY_WEBHOOK_URL="https://app.clay.com/api/v1/webhooks/your-unique-id"
curl -X POST "$CLAY_WEBHOOK_URL" \
-H "Content-Type: application/json" \
-d '{
"email": "jane@acme.com",
"first_name": "Jane",
"last_name": "Doe",
"company": "Acme Corp",
"title": "VP of Sales"
}'
