Webhook Setup Guide

Configure Shopify webhooks to automatically track purchases from your campaigns

Why you need webhooks

Webhooks allow our app to automatically receive notifications when orders are created in your Shopify store. This is essential for:

Tracking purchases that resulted from exit-intent popups
Tracking purchases from floating cart interactions
Calculating accurate conversion rates and revenue metrics
Providing real-time analytics on your dashboard

Step-by-step Setup

Follow these steps to configure the webhook in your Shopify admin

Open Shopify Admin Settings

Go to your Shopify admin panel → Settings → Notifications

Navigate to Webhooks Section

Scroll down to the "Webhooks" section at the bottom of the page

Create New Webhook

Click the "Create webhook" button

Select Event

In the "Event" dropdown, select: Order creation

Set Format

In the "Format" dropdown, select: JSON

Paste Webhook URL

Copy the URL below and paste it into the "URL" field:

https://iydqyhfnaayhtgbioulp.supabase.co/functions/v1/shopify-webhook

Select API Version

In the "Webhook API version" dropdown, select the latest version available (e.g., 2024-10 or newer)

Save Webhook

Click the "Save webhook" button to complete the setup

Verify Webhook is Working

After setting up the webhook, you can verify it's working correctly:

Create a test order in your Shopify store
Wait a few moments for the webhook to be processed
Check your dashboard analytics - the purchase should appear in your metrics
If the purchase shows up, your webhook is configured correctly! ✓

Important Note

The webhook will only track purchases that are associated with a campaign interaction (popup show or floating cart click). Make sure your campaigns are active and you've interacted with them before making a test purchase.

Troubleshooting

Purchases not showing up in analytics?

Verify the webhook URL is correct (no extra spaces or characters)
Check that you selected "Order creation" as the event
Ensure the format is set to "JSON"
Confirm your campaigns are active
Make sure you interacted with a campaign (popup or floating cart) before making the test purchase