Skip to main content

Point Shopify at your capture URL

1

Copy your capture URL

It is on Arrivals: https://in.webhooktrap.dev/c/ followed by a 12-character key.
2

Create the webhook

In the Shopify admin, open Settings › Notifications › Webhooks › Create webhook. Choose format JSON, set the URL to the capture URL, and pick API version 2025-10.
3

Trigger events

Use Send test on the webhook, or create a test order.
Webhook Trap recognises a Shopify delivery by its X-Shopify-Topic header, takes the event type from that header and the event id from X-Shopify-Webhook-Id, and groups events by order and product.

Configure the agent

webhooktrap.yml
If you leave out secret, the agent looks for SHOPIFY_API_SECRET, the name in the Shopify pack.
Your signing secret stays on your machine. webhooktrap.yml holds only the name of the environment variable (secret: env:NAME). The agent reads the value when it signs a delivery, strips every known secret variable from the environment of probe and reset commands, and refuses to write or upload a run document that contains the secret. The server learns the variable’s name, never its value.
Shopify signs no timestamp, so the body and its original X-Shopify-Hmac-Sha256 still verify later. Without the secret the agent sends valid deliveries with the captured signature header; with it, it re-signs them.

What the scenarios do for Shopify

The 5 s budget comes from Shopify’s docs. A budget: above it in webhooktrap.yml is refused as a configuration error.