clay-webhooks-events
Implement Clay webhook signature validation and event handling. Use when setting up webhook endpoints, implementing signature verification, or handling Clay event notifications securely. Trigger with phrases like "clay webhook", "clay events", "clay webhook signature", "handle clay events", "clay notifications".
- License 许可
- MIT
- 最近更新
- 2026-05-26
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- clay-webhooks-events
- author
- Jeremy Longshore <jeremy@intentsolutions.io>
- license
- MIT
- version
- 1.0.0
- description
- Implement Clay webhook signature validation and event handling. Use when setting up webhook endpoints, implementing signature verification, or handling Clay event notifications securely. Trigger with phrases like "clay webhook", "clay events", "clay webhook signature", "handle clay events", "clay notifications".
- allowed-tools
- Read, Write, Edit, Bash(curl:*)
- compatible-with
- claude-code, codex, openclaw
02 资源文件 2
- 参考文档references/implementation-guide.md3.0 KB
- 参考文档references/implementation.md4.6 KB
03 SKILL.md 正文
Clay Webhooks & Events
Overview
Handle Clay webhooks for real-time notifications when data enrichment completes, tables update, or workflows finish. Respond 200 immediately and process events asynchronously.
Prerequisites
- Clay account with API access and webhook configuration enabled
- HTTPS endpoint accessible from the internet
- Clay API key stored in
CLAY_API_KEYenvironment variable - Familiarity with Clay table and enrichment concepts
Webhook Event Types
| Event | Trigger | Payload |
|---|---|---|
enrichment.completed |
Column enrichment finishes | Row data, enrichment results |
enrichment.failed |
Enrichment errors out | Row ID, error details |
table.row.created |
New row added to table | Full row data |
table.row.updated |
Row data changes | Changed fields, row ID |
table.export.completed |
Table export finishes | Export URL, row count |
workflow.completed |
Automated workflow ends | Workflow ID, results summary |
Instructions
Step 1: Configure Webhook Endpoint
Create an Express endpoint that validates the x-clay-signature header using HMAC-SHA256 with crypto.timingSafeEqual. Respond 200 before processing.
Step 2: Route Events by Type
Switch on payload.event to dispatch to specific handlers for enrichment completion, failures, new rows, and exports.
Step 3: Handle Enrichment Results
On enrichment.completed, push enriched data (company info, LinkedIn data) to your CRM. On enrichment.failed, queue for retry with the error details.
Step 4: Register Webhook via Clay API
POST to https://api.clay.com/v1/webhooks with your endpoint URL, desired event types, and table ID.
For complete TypeScript implementations and curl examples, load the reference guide:
Read(${CLAUDE_SKILL_DIR}/references/implementation-guide.md)
Error Handling
| Issue | Cause | Solution |
|---|---|---|
| Invalid signature | Wrong webhook secret | Verify secret in Clay dashboard settings |
| Missing enrichment data | Column not configured | Check enrichment column setup in table |
| Duplicate events | Retry delivery | Track row_id + timestamp for idempotency |
| Webhook timeout | Slow handler | Respond 200 immediately, process async |
Resources
Next Steps
For performance optimization, see clay-performance-tuning.
Output
- Configuration files or code changes applied to the project
- Validation report confirming correct implementation
- Summary of changes made and their rationale
See Clay Webhooks Events implementation details for output format specifications.
Examples
Basic usage: Apply clay webhooks events to a standard project setup with default configuration options.
Advanced scenario: Customize clay webhooks events for production environments with multiple constraints and team-specific requirements.
04 同仓库更多 Skills
zustand-store-ts
Create Zustand stores with TypeScript, subscribeWithSelector middleware, and proper state/action separation. Use when building React state management, creating global stores, or implementing reactive state patterns with Zustand.
zustand-store-creator
Zustand Store Creator - Auto-activating skill for Frontend Development. Triggers on: zustand store creator, zustand store creator Part of the Frontend Development skill category.
zero-trust-config-helper
Zero Trust Config Helper - Auto-activating skill for Security Advanced. Triggers on: zero trust config helper, zero trust config helper Part of the Security Advanced skill category.
zapier-integration-helper
Zapier Integration Helper - Auto-activating skill for Business Automation. Triggers on: zapier integration helper, zapier integration helper Part of the Business Automation skill category.
zai-cli
Execute z.AI CLI providing vision, search, reader, and GitHub exploration via CLI and MCP. Use when user needs image/video analysis, OCR, UI-to-code conversion, error diagnosis, real-time web search, web page to markdown extraction, or GitHub code exploration. Trigger with phrases like "analyze this image", "search the web for", "read this page", "explore this repo", or "use zai". Requires Z_AI_API_KEY.
yt-research
Research competitor YouTube channels, niches, and trending topics for your content strategy. Use this skill whenever the user says "research channels", "analyze competitors", "find trending topics", "niche analysis", "competitive research", "what are other creators doing", "scrape YouTube channels", or wants to understand the competitive landscape for a specific tool or topic area. Use when working with yt research. Trigger with 'yt', 'research'.