AGENT SKILL

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

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_KEY environment 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

SamuelChien
SamuelChien/mega-skills-collection

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.

★ 0
SamuelChien
SamuelChien/mega-skills-collection

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.

★ 0
SamuelChien
SamuelChien/mega-skills-collection

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.

★ 0
SamuelChien
SamuelChien/mega-skills-collection

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.

★ 0
SamuelChien
SamuelChien/mega-skills-collection

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.

★ 0
SamuelChien
SamuelChien/mega-skills-collection

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'.

★ 0