Shopify

Set up the webhook in Shopify

1. Open the Shopify webhook settings in the provider console.
2. Point the webhook at your Hooks endpoint URL (https://api.hooks.events/in/<endpoint-id>).
3. Paste the same secret into the endpoint so Hooks can check X-Shopify-Hmac-Sha256.

Signature verification

• HMAC-SHA256, base64 of the raw body

Events Hooks normalizes

Normalized payload

Every adapter produces this shape before filters or templates run. The raw payload and sanitized headers stay attached for audit, but filters and templates read the normalized fields.

{
  "id": "evt_demo",
  "source": "shopify",
  "type": "shopify.received",
  "action": "received",
  "deliveryId": "delivery_demo",
  "subject": {
    "title": "Shopify event"
  },
  "raw": {}
}

Filter and template examples

type equals "shopify.received"

"Shopify event: {{event.subject.title}}"

Retries and the delivery log

408, 425, 429, and 5xx responses retry with backoff and honor Retry-After; other 4xx responses fail permanently with a named code. Every attempt keeps the rendered request and the target response, so a failure points at one field or one status instead of a guess.

Common errors

Pair with a target

Reference

• Receiving eventshttps://shopify.dev/docs/apps/build/webhooks/verify-webhook-deliveries
• Verify signatureshttps://hooks.events/docs/signatures.md
• Payload templateshttps://hooks.events/docs/templates.md

Other sources