woocommerce-webhooks

Verify WooCommerce webhook signatures and route payloads to handlers.

79|11|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/hookdeck/webhook-skills --skill woocommerce-webhooks
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: woocommerce-webhooks
Source: https://github.com/hookdeck/webhook-skills/tree/main/skills/woocommerce-webhooks
Command: npx skills add https://github.com/hookdeck/webhook-skills --skill woocommerce-webhooks

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill enables you to reliably receive, verify, and process WooCommerce webhooks by validating the HMAC SHA-256 signatures and ensuring only authenticated events are handled.

Core Features & Use Cases

  • Signature verification: Validate X-WC-Webhook-Signature against the raw request body using the shared secret.
  • Event handling: Support common WooCommerce events (order.created, order.updated, product.created, product.updated, customer.created) with deterministic processing.
  • Framework flexibility: Demonstrates implementations across Node.js/Express, Next.js, and FastAPI examples to integrate with your stack.

Quick Start

Use this skill to verify an incoming WooCommerce webhook by supplying the secret via WOOCOMMERCE_WEBHOOK_SECRET and sending a signed payload to /webhooks/woocommerce. Then observe signature verification results and payload processing in your framework of choice.

Frequently Asked Questions about woocommerce-webhooks

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify WooCommerce webhook signatures in Node.js or FastAPI?▼

Verify WooCommerce webhook signatures by validating the X-WC-Webhook-Signature header against the raw request body using your WOOCOMMERCE_WEBHOOK_SECRET with HMAC SHA-256. This Skill automates that exact verification process across Node.js, Next.js, and FastAPI frameworks.

Why does my WooCommerce webhook signature verification fail?▼

WooCommerce webhook signature verification fails when raw body parsing is not enabled or the WOOCOMMERCE_WEBHOOK_SECRET is mismatched. The signature must be computed against the exact raw request body, so any framework-level body parsing modifications will break the HMAC SHA-256 validation.

Do I need raw body parsing to verify WooCommerce webhooks?▼

Yes, raw body parsing is explicitly required to verify WooCommerce webhooks. The HMAC SHA-256 signature validation depends on the original, unparsed request payload to ensure secure and deterministic processing of incoming events.

What WooCommerce webhook events are supported for routing and processing?▼

Supported WooCommerce webhook events include order.created, order.updated, product.created, product.updated, and customer.created. The Skill validates these incoming authenticated payloads and prepares them for deterministic downstream routing and handler processing.

Can I use this Skill to handle WooCommerce webhooks in Next.js?▼

Yes, you can use this Skill to handle WooCommerce webhooks in Next.js. It provides framework-specific implementation examples for Next.js alongside Node.js/Express and FastAPI to validate signatures and route payloads securely.