webflow-webhooks — Claude Code skill: webhooks and setup
webflow-webhooks shows how to receive Webflow events, validate request signatures, and debug handlers. Useful for forms, ecommerce orders, and CMS webhooks.
MIT 190 installs ★ 103 updated 2026-10-22
npx skills add hookdeck/webhook-skills --skill webflow-webhooks -a claude-codeWhat webflow-webhooks does
This skill guides an agent through a Webflow webhook endpoint that keeps the raw request body and checks x-webflow-signature together with x-webflow-timestamp. It builds the expected value with HMAC-SHA256 and rejects timestamps outside a 5-minute window, helping prevent replayed requests.
The material includes an Express handler for form_submission, ecomm_new_order, and CMS collection events. It also covers WEBFLOW_WEBHOOK_SECRET, OAuth and API-created webhook secrets, plus local inspection through npx hookdeck-cli listen 3000 webflow --path /webhooks/webflow.
Webhooks created in the Webflow dashboard do not carry signature headers. Verification also fails when the handler signs parsed JSON instead of the original request bytes.
What it helps with
- receive Webflow events at an HTTP endpoint
- validate the HMAC signature on each request
- route form and ecommerce order events
- handle Webflow CMS item changes
- inspect webhook traffic through a local tunnel
Example prompts for the agent
- Set up an Express Webflow webhook handler that checks
x-webflow-signatureandx-webflow-timestamp. - Add handling for
form_submission,ecomm_new_order, andcollection_item_changedevents. - Debug my failed Webflow signature check while preserving the raw request body.
How to install webflow-webhooks
1Skills CLI (Vercel)
npx skills add hookdeck/webhook-skills --skill webflow-webhooks -a claude-code2Manually: put the files in place
~/.claude/skills/webflow-webhooks/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/webflow-webhooks/
1Skills CLI (Vercel)
npx skills add hookdeck/webhook-skills --skill webflow-webhooks -a codex2Manually: put the files in place
.agents/skills/webflow-webhooks/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add hookdeck/webhook-skills --skill webflow-webhooks -a cursor2Manually: put the files in place
.cursor/skills/webflow-webhooks/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install hookdeck/webhook-skills skills/webflow-webhooks2Manually: put the files in place
.github/skills/webflow-webhooks/SKILL.md1Skills CLI (Vercel)
npx skills add hookdeck/webhook-skills --skill webflow-webhooks -a gemini-cli2Platform CLI
gemini skills install https://github.com/hookdeck/webhook-skills --path skills/webflow-webhooksManually: put the files in place
.devin/skills/webflow-webhooks/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add hookdeck/webhook-skills --skill webflow-webhooks -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about webflow-webhooks
How do I install webflow-webhooks in Claude Code?
Run npx skills add hookdeck/webhook-skills --skill webflow-webhooks -a claude-code. The skill file will be at ~/.claude/skills/webflow-webhooks/SKILL.md.
What does webflow-webhooks do?
It helps set up Webflow webhook receivers, validate HMAC-SHA256 signatures, and route form, order, publishing, and CMS events.
Which Webflow webhooks include signature headers?
Webhooks created through OAuth apps or the API include x-webflow-signature and x-webflow-timestamp. Webhooks made in the Webflow dashboard do not include them.
Source text
SKILL.md · MIT
---
name: webflow-webhooks
description: Receive and verify Webflow webhooks. Use when setting up Webflow webhook handlers, debugging signature verification, or handling Webflow events like form_submission, site_publish, ecomm_new_order, or collection item changes.
license: MIT
metadata:
author: hookdeck
version: "0.1.0"
repository: https://github.com/hookdeck/webhook-skills
---
# Webflow Webhooks
## When to Use This Skill
- How do I receive Webflow webhooks?
- How do I verify Webflow webhook signatures?
- How do I handle form_submission events from Webflow?
- How do I process Webflow ecommerce order events?
- Why is my Webflow webhook signature verification failing?
- Setting up Webflow CMS collection item webhooks
## Essential Code
### Signature Verification (Manual)
```javascript
const crypto = require('crypto');
function verifyWebflowSignature(rawBody, signature, timestamp, secret) {
// Check timestamp to prevent replay attacks (5 minute window - 300000 milliseconds)
const currentTime = Date.now();
if (Math.abs(currentTime - parseInt(timestamp)) > 300000) {
return false;
}
// Generate HMAC signature
const signedContent = `${timestamp}:${rawBody}`;
const expectedSignature = crypto
.createHmac('sha256', secret)
.update(signedContent)
.digest('hex');
// Timing-safe comparison
try {
return crypto.timingSafeEqual(
Buffer.from(signature),
Buffer.from(expectedSignature)
);
} catch {
return false; // Different lengths = invalid
}
}
```
### Processing Events
```javascript
app.post('/webhooks/webflow', express.raw({ type: 'application/json' }), (req, res) => {
const signature = req.headers['x-webflow-signature'];
const timestamp = req.headers['x-webflow-timestamp'];
if (!signature || !timestamp) {
return res.status(400).send('Missing required headers');
}
// Verify signature (use OAuth client secret or webhook-specific secret)
const isValid = verifyWebflowSignature(
req.body.toString(),
signature,
timestamp,
process.env.WEBFLOW_WEBHOOK_SECRET
);
if (!isValid) {
return res.status(400).send('Invalid signature');
}
// Parse the verified payload
const event = JSON.parse(req.body);
// Handle different event types
switch (event.triggerType) {
case 'form_submission':
console.log('New form submission:', event.payload.data);
break;
case 'ecomm_new_order':
console.log('New order:', event.payload);
break;
case 'collection_item_created':
console.log('New CMS item:', event.payload);
break;
// Add more event handlers as needed
}
// Always return 200 to acknowledge receipt
res.status(200).send('OK');
});
```
## Common Event Types
| Event | Triggered When | Use Case |
|-------|----------------|----------|
| `form_submission` | Form submitted on site | Contact forms, lead capture |
| `site_publish` | Site is published | Clear caches, trigger builds |
| `ecomm_new_order` | New ecommerce order | Order processing, inventory |
| `ecomm_order_changed` | Order status changes | Update fulfillment systems |
| `collection_item_created` | CMS item created | Content syndication |
| `collection_item_changed` | CMS item updated | Update external systems |
| `collection_item_deleted` | CMS item deleted | Remove from external systems |
| `collection_item_published` | CMS item published | Invalidate caches, publish downstream |
Webflow documents 13 event types on
[All Events](https://developers.webflow.com/data/reference/all-events); its
official `webflow-api` SDK `TriggerType` enum carries those plus
`collection_item_published`. The `user_account_*` events are deprecated — see
[references/overview.md](references/overview.md#deprecated-event-types).
## Environment Variables
```bash
# For webhooks created via OAuth App
WEBFLOW_WEBHOOK_SECRET=your_oauth_client_secret
# For webhooks created via API (after April 2025)
WEBFLOW_WEBHOOK_SECRET=whsec_xxxxx # Returned when creating webhook
```
## Local Development
For local webhook testing, install Hookdeck CLI:
```bash
```
Then start the tunnel:
```bash
npx hookdeck-cli listen 3000 webflow --path /webhooks/webflow
```
No account required. Provides local tunnel + web UI for inspecting requests.
## Resources
- [What Are Webflow Webhooks](references/overview.md) - Event types and payload structure
- [Setting Up Webflow Webhooks](references/setup.md) - Dashboard configuration and API setup
- [Signature Verification Details](references/verification.md) - In-depth verification guide
- [Express Example](examples/express/) - Node.js implementation with tests
- [Next.js Example](examples/nextjs/) - App Router implementation
- [FastAPI Example](examples/fastapi/) - Python implementation
## Important Notes
- Webhooks created through the Webflow dashboard do NOT include signature headers
- Only webhooks created via OAuth apps or API include `x-webflow-signature` and `x-webflow-timestamp`
- Always use raw body for signature verification, not parsed JSON
- Timestamp validation (5 minute window - 300000 milliseconds) is critical to prevent replay attacks
- Return 200 status to acknowledge receipt; other statuses trigger retries (up to 3 times)
## Recommended: webhook-handler-patterns
This skill pairs well with webhook-handler-patterns for production-ready implementations:
- [Handler sequence](https://github.com/hookdeck/webhook-skills/blob/main/skills/webhook-handler-patterns/references/handler-sequence.md) — Request flow and middleware order
- [Idempotency](https://github.com/hookdeck/webhook-skills/blob/main/skills/webhook-handler-patterns/references/idempotency.md) — Handling duplicate events
- [Error handling](https://github.com/hookdeck/webhook-skills/blob/main/skills/webhook-handler-patterns/references/error-handling.md) — Graceful failure and recovery
- [Retry logic](https://github.com/hookdeck/webhook-skills/blob/main/skills/webhook-handler-patterns/references/retry-logic.md) — Handling failed processing
## Related Skills
- [stripe-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/stripe-webhooks) - Stripe webhook handling with similar HMAC-SHA256 verification
- [shopify-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/shopify-webhooks) - Shopify webhook implementation
- [github-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/github-webhooks) - GitHub webhook handling
- [webhook-handler-patterns](https://github.com/hookdeck/webhook-skills/tree/main/skills/webhook-handler-patterns) - Production patterns for all webhooks
- [hookdeck-event-gateway](https://github.com/hookdeck/webhook-skills/tree/main/skills/hookdeck-event-gateway) - Webhook infrastructure and reliability
Sources:
- [Working with Webhooks – Webflow Docs](https://developers.webflow.com/data/docs/working-with-webhooks)
- [Webhook Signatures Changelog](https://developers.webflow.com/data/changelog/webhook-signatures)
© hookdeck · MIT · hookdeck/webhook-skills