Agent skill · software engineering · jeremylongshore
clay-sdk-patterns
Apply production-ready patterns for integrating with Clay via webhooks
Why this skill is useful
Provides reusable TypeScript patterns for integrating with Clay's webhook and HTTP API that the AI wouldn't generate on its own.
What it needs
Requires npm 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 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) Step 2: Type Definitions for Clay Data Step 3: Python Client Step 4: Singleton Pattern for Multi-Use Error Handling Pattern Use Case Benefit --------- ---------- --------- Retry with backoff 429 rate limits, network errors Automatic recovery Batch with delay Sending many rows Respects Clay rate limits Enterprise API guard Missing API key Clear error before API call Timeout control Slow webhook delivery Prevents hung connections Examples Webhook Handler for Clay Callbacks Output Return typed, validated enrichment results or a classified retryable/terminal failure with a correlation ID. The client and callback boundary must redact webhook URLs, credentials, and unneeded lead attributes in logs; callers must not treat an HTTP acknowledgement as proof that downstream enrichment was processed. Resources Clay University -- HTTP API Integration Clay University -- Webhook Guide Clay University -- Using Clay as an API Next Steps Apply patterns in clay-core-workflow-a for real-world lead enrichment.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/clay-sdk-patterns