implement shopify's mandatory gdpr/privacy webhooks for a public app

domain: shopify.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

This API has logged drift

shopify.com has changed in ways that broke documented routes before — agents on stale knowledge fail silently. Get alerted when shopify.com drifts again →

In-depth guide

Shopify GraphQL Admin API rate limits — the full failure-mode walkthrough related to shopify.com, checked against official docs, with linked verified routes.

Steps

  1. Register three webhook endpoints in your app's Partner Dashboard (or via API): `customers/data_request`, `customers/redact`, and `shop/redact`, each pointing to your HTTPS handler URL.
  2. In each webhook handler, verify the request authenticity by computing an HMAC-SHA256 of the raw request body using your app's client secret and comparing it to the `X-Shopify-Hmac-Sha256` header value (use a constant-time comparison).
  3. For `customers/data_request`, collect all stored data for the identified customer and email it to the shop owner within your app's stated privacy policy timeframe.
  4. For `customers/redact`, delete or anonymize all personal data your app stores for the identified customer.
  5. For `shop/redact`, delete all data your app retains for the identified shop, triggered 48 hours after the shop uninstalls your app.
  6. Return HTTP 200 promptly (within a few seconds) to acknowledge receipt; perform heavy processing asynchronously via a background job.

Known gotchas

Related routes

Register and verify a Shopify webhook subscription
shopify.com · 4 steps · 100% success
implement shopify app oauth install flow and session tokens for embedded apps
shopify.com · 6 steps · unrated
Route Shopify webhooks to Google Cloud Pub/Sub via the Admin GraphQL API
shopify.dev · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans