shopify-webhooks

Verify Shopify webhook signatures with X-Shopify-Hmac-SHA256 across Express, Next.js, and FastAPI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill enables developers to safely receive and verify Shopify webhook events, ensuring only authentic requests from stores are processed.

Core Features & Use Cases

  • Webhook reception and verification: Provide a secure endpoint that validates X-Shopify-Hmac-SHA256 against the shared secret.
  • Multi-runtime examples: Includes runnable guides for Express (Node.js), Next.js App Router, and FastAPI to cover common runtimes.
  • Event coverage and compliance: Demonstrates handling events like orders/create, products/update, customers/create, and GDPR webhooks (data_request, redact).

Quick Start

Set up a Shopify webhook endpoint using the included examples, configure the SHOPIFY_API_SECRET, and test with Hookdeck or ngrok.

Frequently Asked Questions about shopify-webhooks

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

FAQPage Schema
How do I verify Shopify webhooks using HMAC signature checks?

To verify Shopify webhooks, you validate the X-Shopify-Hmac-SHA256 header against your shared secret using the raw request body. This Skill provides runnable examples for Express, Next.js, and FastAPI to ensure secure delivery and authentic event processing.

Can I handle Shopify GDPR webhooks like customer data redaction?

Yes, you can handle Shopify GDPR webhooks including data_request and redaction events. This Skill demonstrates secure endpoint setup for these compliance events alongside standard operations like orders/create and customers/create.

Does this webhook signature verification work with Next.js App Router?

Yes, webhook signature verification works with Next.js App Router. This Skill includes multi-runtime examples covering Next.js, Express, and FastAPI to validate X-Shopify-Hmac-SHA256 across common frameworks.

Why does Shopify webhook verification fail without raw body handling?

Shopify webhook verification fails without raw body handling because the HMAC signature is calculated against the exact raw payload. Modifying the body before verifying the X-Shopify-Hmac-SHA256 header alters the hash and invalidates the signature check.

How do I securely manage the Shopify API secret for webhook endpoints?

You securely manage the Shopify API secret by storing it in your environment variables. This Skill requires configuring the SHOPIFY_API_SECRET to validate the X-Shopify-Hmac-SHA256 header and authenticate incoming webhook events safely.

What is the best way to test Shopify webhook reception locally?

The best way to test Shopify webhook reception locally is by using tunneling tools like ngrok or Hookdeck. This allows you to expose your local Express, Next.js, or FastAPI endpoint to receive and verify live Shopify webhook events.