Clay platform help — Waterfall Enrichment (150+ data providers), Claygent (AI Research Agents), Sculptor (workflow builder), Signals (job changes, intent), Audiences, Ad Sync (LinkedIn/Meta/Google), Email Sequencer, CRM Sync (Salesforce/HubSpot/Dynamics), HTTP API actions, webhooks. Use when enrichment data has gaps or low match rates, Claygent not returning useful research, Sculptor workflows failing or hard to build, signals missing job changes you care about, audiences not syncing to ad platforms, CRM data out of sync with Clay, or webhooks not firing. Do NOT use for enrichment strategy across tools (use /sales-enrich), cadence/sequence strategy across tools (use /sales-cadence), intent signal strategy across tools (use /sales-intent), B2B advertising strategy across tools (use /sales-b2b-advertising), or CRM data hygiene strategy across tools (use /sales-data-hygiene).
Help the user with Clay platform questions — from waterfall enrichment and Claygent AI agents through Sculptor workflows, Signals, Audiences, Ad Sync, Email Sequencer, CRM sync, and webhook/API integrations.
If references/learnings.md exists, read it first for accumulated knowledge.
Ask the user:
What area of Clay do you need help with?
What's your role?
What are you trying to accomplish? (describe your specific goal or question)
If the user's request already provides most of this context, skip directly to the relevant step. Lead with your best-effort answer using reasonable assumptions (stated explicitly), then ask only the most critical 1-2 clarifying questions at the end — don't gate your response behind gathering complete context.
If the request maps to a specialized skill, route:
/sales-enrich/sales-cadence/sales-intent/sales-b2b-advertising/sales-data-hygiene/sales-prospect-list/sales-lead-score/sales-integrationOtherwise, answer directly using the platform reference below.
Read references/platform-guide.md for detailed module documentation, pricing, integrations, and data model.
You no longer need the platform guide details — focus on the user's specific situation.
When answering, always:
Best-effort from research — review these, especially items about plan-gated features and integration gotchas that may be outdated.
Credit burn from waterfall enrichment is the #1 surprise cost. Each provider in a waterfall consumes credits independently. A 5-provider waterfall on 10,000 rows can burn 50,000 credits if you're not using "only if empty" logic. Always test on small batches and monitor credit usage in table settings.
No public REST API — webhook-only integration model. Clay doesn't expose traditional API endpoints for managing tables or data programmatically. All external integration is via inbound webhooks (POST to table URL) and outbound HTTP API actions. This surprises developers expecting a standard CRUD API.
CRM Sync requires Growth plan ($446+/mo). Many users sign up for Launch expecting to sync with Salesforce/HubSpot, then discover CRM sync is plan-gated. Same for HTTP API and webhooks — all require Growth.
Claygent results vary with prompt quality. AI research agents are powerful but sensitive to instruction quality. Vague prompts produce inconsistent results. Always write specific, structured instructions and test on 5-10 rows before scaling.
Data credit costs vary by provider — not all enrichments cost the same. A Hunter email lookup might cost 1 credit while a ZoomInfo enrichment costs 10+. The waterfall order matters for cost optimization, not just coverage.
references/learnings.md with today's date./sales-enrich — Enrichment strategy across all tools (for choosing providers, comparing approaches)/sales-cadence — Multi-channel outbound sequence design (for cadence strategy beyond Clay's sequencer)/sales-intent — Buying signals and account prioritization (for signal strategy beyond Clay's Signals)/sales-prospect-list — Building targeted prospect lists (for list strategy)/sales-lead-score — Lead scoring models (for scoring strategy using Clay's enrichment data)/sales-b2b-advertising — B2B advertising strategy (for ad strategy beyond Clay's Ad Sync)/sales-data-hygiene — CRM data hygiene (for data quality strategy using Clay's CRM sync)/sales-integration — Connecting tools with webhooks, Zapier, APIs/sales-do — Not sure which skill to use? The router matches any sales objective to the right skill. Install: npx skills add sales-skills/sales --skills sales-doUser says: "I have a list of 5,000 leads with names and companies but no emails. How do I find their work emails in Clay?" Skill does: Recommends waterfall enrichment with provider order (Hunter → Dropcontact → Apollo → People Data Labs), "only if empty" logic between steps, small batch test first (50 rows), and credit budget estimate. Result: Step-by-step waterfall setup with provider prioritization and cost optimization.
User says: "I want to automatically enrich and email prospects when they change jobs at target accounts." Skill does: Walks through Signals setup (job change trigger), enrichment waterfall for new role details, Claygent for company research, Email Sequencer for personalized outreach, and CRM sync to log activity. Notes Launch plan minimum for Signals. Result: End-to-end automated workflow from signal detection through outbound.
User says: "Should I use Clay or Apollo for contact enrichment? We already have Apollo." Skill does: Explains Clay's waterfall approach (150+ providers, higher coverage) vs Apollo's single-database model (275M+ contacts, simpler). Notes Clay as an enrichment orchestrator that can include Apollo as one provider. Recommends Clay for teams needing maximum coverage; Apollo alone for teams prioritizing simplicity and built-in outbound. Result: Clear comparison with recommendation based on team needs.
Symptom: Running waterfall enrichment but only getting 30-40% email coverage. Cause: Provider order may not be optimized, or input data quality is poor (misspelled company names, outdated titles). Solution: Clean input data first — standardize company names and verify LinkedIn URLs. Reorder providers with highest-coverage providers first. Add more providers to the waterfall (5-7 is typical for 80%+ coverage). Check that "only if empty" logic is working correctly between providers. Test with a small batch to identify which providers perform best for your ICP.
Symptom: Data Credits depleted before the monthly cycle ends. Cause: Waterfall enrichment without "only if empty" logic queries every provider for every row, even if the first one succeeds. Multi-column enrichment compounds costs (email + phone + company = 3x credits per row). Solution: Add "only if empty" conditions between waterfall steps. Prioritize cheaper providers first. Run enrichment on high-priority segments rather than entire database. Monitor per-provider credit consumption in table settings. Consider upgrading plan for more credits if the ROI justifies it.
Symptom: Enriched data isn't syncing back to Salesforce/HubSpot.
Cause: CRM sync requires Growth plan ($446+/mo). Also, field mapping must be configured correctly — Clay column names must map to CRM field API names, not display labels.
Solution: Verify you're on Growth plan or above. Check field mapping in the CRM integration settings — use API field names (e.g., Email not "Email Address"). Test sync with a single row before bulk operations. Check CRM-side permissions — the connected user needs create/update access on the target object.