clay-reference-architecture

Clay Reference Architecture

Overview

Production architecture for Clay-based lead enrichment and data operations. Covers table design, enrichment pipeline patterns, webhook integration, and CRM synchronization flows.

Prerequisites

• Clay account with API access
• Understanding of Clay tables and enrichment columns
• CRM integration configured (HubSpot, Salesforce)
• Webhook endpoint for automation triggers

Instructions

Step 1: Design Table Schema

Define input columns (company name, domain, contact, LinkedIn URL), enrichment columns (company size, industry, email, phone, technologies), formula columns (ICP score, lead tier), and AI columns (personalized intro, pain points).

Step 2: Configure Enrichment Waterfall

Order providers by cost: Apollo (1 credit) -> Hunter (1) -> Dropcontact (2) -> Findymail (3). Enable "stop on first result" to minimize credit usage.

Step 3: Set Up Webhook Integration

On enrichment completion, check ICP score. Push high-value leads (score >= 80 with valid email) to CRM immediately. Add tier-A leads to outreach sequences.

Step 4: Implement ICP Scoring Formula

Weight company size (up to 50 pts), target industry match (30 pts), and technology stack matches (10 pts each, max 100 total).

For architecture diagrams, TypeScript implementations, and ICP scoring code, load the reference guide: Read(${CLAUDE_SKILL_DIR}/references/implementation-guide.md)

Error Handling

Issue	Cause	Solution
Enrichment credits exhausted	Too many lookups	Use waterfall pattern, set daily limits
Duplicate records	Re-importing same list	Deduplicate on domain + contact name
Webhook timeout	Processing too slow	Acknowledge immediately, process async
Low email find rate	Bad input data	Validate domains before enrichment

Resources

• Clay API Documentation
• Clay Enrichment Providers
• Clay Formulas Guide

Output

• Configuration files or code changes applied to the project
• Validation report confirming correct implementation
• Summary of changes made and their rationale

See design implementation details for output format specifications.

Examples

Basic usage: Apply clay reference architecture to a standard project setup with default configuration options.

Advanced scenario: Customize clay reference architecture for production environments with multiple constraints and team-specific requirements.