Shopify setup
Hooks uses Shopify's custom app flow (Private App approach). You create an app in your store admin, register a webhook, and paste the API secret key for signature verification.
Step 1: Open Shopify Admin
Sign in to your store's Shopify Admin.
Step 2: Create or open a custom app
Go to Settings → Apps and sales channels → Develop apps. Create a custom app (or open an existing one).
Step 3: Configure webhooks
In the app, open Configuration → Admin API integration (or Webhooks, depending on your admin version). Click Create webhook.
Step 4: Paste your Hooks URL
Copy the webhook URL from your Hooks Shopify endpoint setup page and paste it as the webhook URL. Choose an API version and topics such as orders/create.
Step 5: Save and copy the API secret key
Shopify signs webhooks with your app's API secret key (under App credentials). Paste that key into Hooks so we can verify the X-Shopify-Hmac-Sha256 header.
Troubleshooting
Signature verification failed
Use the API secret key from the same custom app that owns the webhook—not the Admin API access token. If you regenerate the secret in Shopify, update Hooks immediately.
Events not arriving
- Confirm the webhook topic matches what you expect (e.g. orders/create vs orders/paid).
- Place a test order or use Shopify's webhook delivery log in the admin.
- Check that your Hooks endpoint is active (not paused).
Dashboard shows no events
After saving the secret in Hooks, trigger a test order or use Send test event from the endpoint page.