Agent skill · data analytics · jeremylongshore
clay-common-errors
Diagnose and fix the most common Clay errors and integration issues.
Why this skill is useful
Provides specific troubleshooting commands and integration patterns for Clay that the AI wouldn't reliably generate on its own.
What it needs
Requires curl, jq installed locally. Requires clay account access. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Clay Common Errors Overview Quick reference for the top 12 most common Clay errors across webhooks, enrichment columns, HTTP API columns, Claygent, and CRM integrations. Each error includes the exact symptom, root cause, and fix. Prerequisites Clay account with an active table Access to Clay table error indicators (red cells, exclamation marks) Browser developer tools for webhook debugging Instructions Error 1: Webhook Returns 422 Unprocessable Entity Symptom: Data sent to webhook URL but rows never appear in table. Cause: Invalid JSON payload or missing Content-Type header. Fix: --- Error 2: Webhook URL Returns 404 Symptom: 404 Not Found when POSTing to webhook URL. Cause: Table was deleted, webhook was replaced, or URL was copied incorrectly. Fix: Open the Clay table, click + Add > Webhooks > Monitor webhook, and re-copy the URL. Each table has a unique webhook ID. --- Error 3: Enrichment Column Shows "No Data Found" Symptom: Enrichment column returns empty for most rows. Cause: Input data quality is poor (personal email domains, invalid domains, missing fields). Fix: --- Error 4: "Credit Balance Insufficient" Symptom: Enrichment stops mid-table with credit error. Cause: Monthly credit allowance exhausted. Fix: Check credit balance in Settings > Plans & Billing. Options: Connect your own provider API keys (saves 70-80% credits) Reduce waterfall depth (fewer providers = fewer credits per row) Upgrade plan for more monthly credits --- Error 5: Webhook Submission Limit Reached (50K) Symptom: Webhook stops accepting new submissions silently. Cause: Each webhook source has a hard limit of 50,000 submissions. Fix: Create a new webhook source on the same table. The 50K limit persists even after deleting rows -- you must create a fresh webhook. --- Error 6: HTTP API Column Returns Error Symptom: Red error indicator on HTTP API enrichment column cells. Cause: Target API URL is wrong, auth header is incorrect, or response format unexpected. Fix: 1. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/clay-common-errors