clay-deploy-integration

# Clay Deploy Integration ## Overview Deploy applications that integrate with Clay (webhook receivers, enrichment processors, CRM sync services) to production platforms. Clay itself is a hosted SaaS -- you deploy the code that *interacts* with Clay, not Clay itself. The critical requirement is a publicly accessible HTTPS endpoint for Clay's HTTP API columns to call back to. ## Prerequisites - Application code that handles Clay webhooks or HTTP API callbacks - Platform CLI installed (vercel, gcloud, or docker) - Clay webhook URL and/or API key stored securely - HTTPS endpoint accessible from the public internet ## Instructions ### Step 1: Vercel Deployment (Serverless) Best for: Webhook receivers, small-scale enrichment handlers. ```bash # Set Clay secrets in Vercel vercel env add CLAY_WEBHOOK_URL production vercel env add CLAY_API_KEY production vercel env add CLAY_WEBHOOK_SECRET production # Deploy vercel --prod ``` ```typescript // api/clay/callback.ts — Vercel serverless function import type { VercelRequest, VercelResponse } from '@vercel/node'; import crypto from 'crypto'; export default async function handler(req: VercelRequest, res: VercelResponse) { if (req.method !== 'POST') return res.status(405).end(); // Validate webhook signature const signature = req.headers['x-clay-signature'] as string; const secret = process.env.CLAY_WEBHOOK_SECRET!; const expected = crypto.createHmac('sha256', secret) .update(JSON.stringify(req.body)) .digest('he...