clay-sdk-patterns

# Clay Integration Patterns ## Overview Production-ready patterns for Clay integrations. Clay does not have an official SDK -- you interact via webhooks (inbound), HTTP API enrichment columns (outbound from Clay), and the Enterprise API (programmatic lookups). These patterns wrap those interfaces into reliable, reusable code. ## Prerequisites - Completed `clay-install-auth` setup - Familiarity with async/await patterns - Understanding of Clay's webhook and HTTP API model ## Instructions ### Step 1: Create a Clay Webhook Client (TypeScript) ```typescript // src/clay/client.ts — typed wrapper for Clay webhook and Enterprise API interface ClayConfig { webhookUrl: string; // Table's webhook URL for inbound data enterpriseApiKey?: string; // Enterprise API key (optional) baseUrl?: string; // Default: https://api.clay.com maxRetries?: number; timeoutMs?: number; } class ClayClient { private config: Required<ClayConfig>; constructor(config: ClayConfig) { this.config = { baseUrl: 'https://api.clay.com', maxRetries: 3, timeoutMs: 30_000, enterpriseApiKey: '', ...config, }; } /** Send a record to a Clay table via webhook */ async sendToTable(data: Record<string, unknown>): Promise<void> { const res = await this.fetchWithRetry(this.config.webhookUrl, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(data), }); if (!res.ok) { thr...