Back to Documentation

Shopify Webhook Integration Setup

Complete guide to setting up real-time order synchronization between Shopify and InventoryInsights

Overview

Shopify webhook integration provides real-time order updates as soon as they occur in your store. This requires manual setup in Shopify Admin to configure webhooks and obtain credentials.

What You'll Need:

  • • Shopify store with admin access
  • • Private app development permissions
  • • Admin API access token
  • • Webhook secret

1Create Shopify Private App

Navigate to App Development

Go to Shopify Admin → Apps → Develop apps

Create New App

Click Create an app and give it a descriptive name like "InventoryInsights Integration"

Configure Permissions

In the Configuration tab, set permissions:
• Orders → Read access

2Create API Credentials

Admin API Access Token

Go to API credentials tab → Create API credential → Private app access token
  1. 1. Configure Admin API access token with Orders → Read access
  2. 2. Copy the Admin API access token (starts with shpat_)
  3. 3. Store this securely - you'll need it for the integration setup

Important

The Admin API access token is required for both webhook validation and future features. Keep it secure and never share it publicly.

3Configure Webhooks

Add Webhook Subscription

In the same app configuration, go to the Webhooks section and add:

Topic: order/create
Format: JSON
Webhook URL: https://inventoryinsights.org/api/webhooks/shopify
Webhook API version: Latest stable version

Copy Webhook Secret

After creating the webhook, Shopify will generate a webhook secret. Copy this value - it's required for validating that incoming webhooks are actually from Shopify.

4Create Integration in InventoryInsights

Navigate to Integrations

Go to Settings → Integrations and click Add New Integration

Select Shopify Webhook

Choose Shopify Webhook from the available integration types

Fill Required Fields

  • • Integration Name: Give it a descriptive name (e.g., "My Store - Webhook")
  • • Shop Domain: Your store domain (e.g., your-store.myshopify.com)
  • • Access Token: Paste the Admin API access token from Step 2
  • • Webhook Secret: Paste the webhook secret from Step 3

Create Integration

Click Create Integration to complete the setup

Verify Setup

Create a test order in your Shopify store

Check that the order appears in your InventoryInsights dashboard

Monitor webhook logs in Shopify Admin for any delivery failures

Important Notes

  • • The webhook URL must be publicly accessible and use HTTPS (already handled by the system)
  • • Both access token and webhook secret are required for complete functionality
  • • Webhook secrets are stored securely in the vault
  • • The system validates webhook signatures to ensure authenticity
  • • Failed webhook deliveries are logged and can be retried

Helpful Links

Shopify Webhooks DocumentationBuilding Private AppsWebhook Topics Reference