Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.upstackdata.com/llms.txt

Use this file to discover all available pages before exploring further.

Data direction: This is a source — data flows into Upstack from this platform for analytics, reporting, and enrichment.
Shopify webhooks deliver real-time notifications to Upstack whenever data changes in your store — new orders, customer updates, product modifications, and app lifecycle events. This ensures your Upstack dashboard reflects changes within seconds instead of waiting for periodic API syncs.

​
Registered Webhooks

When you install the Upstack Data app, the following webhooks are automatically registered with your Shopify store:
Webhook TopicFires WhenWhat Upstack Does
orders/createA new order is placedIngests order data for purchase attribution and revenue tracking
orders/updatedAn existing order is modified (fulfillment, refund, cancellation)Updates attributed revenue and order status
orders/cancelledAn order is cancelledMarks the conversion as cancelled and adjusts revenue
customers/createA new customer account is createdAdds the customer to the identity graph
customers/updateCustomer profile changes (email, address, tags)Merges updated data into the existing identity profile
products/createA new product is publishedUpdates the product catalog for content ID matching
products/updateA product is modified (price, title, variants)Syncs product changes for accurate event parameters
app/uninstalledThe Upstack app is removed from the storeDeactivates the source and stops data collection
Upstack does not register webhooks for draft orders, inventory, or fulfillment events. These may be added in future releases based on customer demand.

​
How Webhook Processing Works

When Shopify fires a webhook, the following pipeline executes:
  1. Receive — Upstack’s ingestion endpoint receives the webhook payload and validates the HMAC signature to confirm it originated from Shopify.
  2. Normalize — The raw Shopify payload is transformed into Upstack’s internal event schema. For example, an orders/create webhook becomes a Purchase event with standardized fields.
  3. Enrich — The event is passed through identity resolution. If the order includes a customer email, Upstack links it to any existing anonymous sessions from that visitor.
  4. Store and forward — The normalized event is stored for analytics and simultaneously queued for delivery to any active destinations.
HMAC validation is mandatory. Every incoming webhook is verified against your store’s shared secret. If validation fails, the payload is rejected and logged as a security event. You do not need to configure this — it’s handled automatically during app installation.

​
Retry and Reliability

Shopify’s webhook infrastructure includes automatic retry logic:
  • If Upstack’s endpoint returns a non-2xx response, Shopify retries the webhook up to 19 times over a 48-hour period with exponential backoff.
  • If all retries fail, Shopify marks the webhook as failed. Upstack’s daily reconciliation sync catches these gaps by pulling any missing orders via the Shopify API.
  • Webhooks that consistently fail may cause Shopify to automatically remove the webhook registration. If this happens, Upstack detects the removal and re-registers the webhook.
This dual approach (webhooks + daily reconciliation) ensures no data is permanently lost, even during extended outages or high-traffic events like flash sales.

​
Verifying Webhooks Are Working

1

Check webhook status in the Upstack dashboard

Navigate to Integrations → Sources → Shopify. The source detail page shows a Webhook Health indicator:
  • Healthy (green) — webhooks are being received and processed normally
  • Delayed (yellow) — some webhooks have failed but retries are in progress
  • Failing (red) — webhooks are consistently failing; check Shopify admin for details
2

Trigger a test event

Place a test order on your Shopify store (you can use Shopify’s Bogus Gateway for free test transactions). Within 30 seconds, the order should appear in the Upstack Live Event Stream as a Purchase event.
3

Check Shopify's webhook logs

In your Shopify admin, go to Settings → Notifications → Webhooks. Shopify shows recent webhook deliveries with status codes. Look for deliveries to Upstack’s endpoint — they should all show 200 responses.
Shopify’s webhook log in the admin panel shows the last 30 days of delivery attempts. Use this to diagnose intermittent failures.

​
Troubleshooting

If Shopify reports webhook delivery failures to Upstack’s endpoint:
  1. Check the Upstack status page for any ongoing incidents
  2. Verify your Shopify store hasn’t recently changed its domain (this can invalidate webhook registrations)
  3. In the Upstack dashboard, go to Integrations → Sources → Shopify and click Reconnect to re-register webhooks
Failed webhooks are retried by Shopify for up to 48 hours, and Upstack’s daily reconciliation sync fills any remaining gaps.
Brief delays (under 5 minutes) are normal during high-traffic periods. Shopify queues webhooks and delivers them in order, which can introduce latency during peak times like Black Friday.If delays consistently exceed 30 minutes, check whether your Shopify store is near its API rate limit. High-volume stores on the Basic plan may experience more webhook queuing than stores on Advanced or Plus plans.
Shopify automatically removes webhook registrations if the receiving endpoint returns errors for an extended period. Upstack monitors for this and re-registers webhooks automatically.If you notice a gap in data, check Integrations → Sources → Shopify for a “Webhooks re-registered” notification. Any missed data during the gap is recovered during the next daily reconciliation sync.
Still stuck? Contact support@upstackdata.com with your Pixel ID and a description of the issue. We typically respond within a few hours.

Connect Shopify

Step-by-step setup guide for connecting your Shopify store.

Troubleshooting: Data Stopped Syncing

End-to-end diagnostic guide when source data stops flowing into Upstack.

Events Taxonomy

How Shopify webhook events map to Upstack’s standard event taxonomy.