clay-rate-limits

# Clay Rate Limits ## Overview Clay enforces rate limits at the plan level, webhook level, and enrichment provider level. Understanding these limits prevents data loss, credit waste, and integration failures. ## Prerequisites - Clay account with known plan tier - Webhook URL(s) for your tables - Understanding of your data volume requirements ## Instructions ### Step 1: Understand Clay Rate Limit Tiers | Plan | Records/Hour | Webhook Limit | HTTP API Columns | Enterprise API | |------|-------------|---------------|-----------------|----------------| | Free | Limited | 50K lifetime per webhook | Not available | Not available | | Starter | Standard | 50K lifetime per webhook | Not available | Not available | | Explorer | 400/hour | 50K lifetime per webhook | Not available | Not available | | Pro | Unlimited | 50K lifetime per webhook | Available | Not available | | Enterprise | Unlimited | 50K lifetime per webhook | Available | Available | **Key insight:** The 50K webhook submission limit is per-webhook, not per-table. Once exhausted, create a new webhook on the same table. ### Step 2: Implement Webhook Rate Limiting ```typescript // src/clay/rate-limiter.ts — respect Clay's plan-level rate limits import PQueue from 'p-queue'; interface RateLimiterConfig { maxPerHour: number; // Plan limit (e.g., 400 for Explorer) maxPerSecond: number; // Practical burst limit webhookLimit: number; // 50K per webhook lifetime } const PLAN_LIMITS: Record<string, RateLimi...