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.