Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage
  1. Home
  2. /
  3. Channels
  4. /
  5. Shopify Integration

Shopify Integration

Introduction

The SmartConsign – Shopify integration allows you to import Shopify orders directly into the SmartConsign portal, where shipments are created and managed manually.

This integration focuses on reliable order import, manual shipment control, and clean Shopify timelines.

Prerequisites

Before starting, ensure you have:

  • A Shopify storefront
  • A SmartConsign account with portal access
  • Shopify permissions to create apps and webhooks

Integration Overview

Once the integration is active:

  • Orders created in Shopify are imported into SmartConsign.
  • Each order creates an Unallocated Shipment.
  • Shipments and labels are created manually in SmartConsign.
  • Tracking information is automatically fulfilled back to Shopify once the label is created in the SmartConsign portal.
  • No SmartConsign notes are added to the Shopify order timeline.

Required Information

When creating the channel, enter the values exactly as shown in the SmartConsign portal UI.

All the data below will be generated by following the steps to create the App and Webhooks, Then you will need to provide this into the SmartConsign portal to link the Shopify store to SmartConsign.

SmartConsign Field Shopify Value
Private App Client Id Client Id (32 characters: letters and digits)
Private App Secret Secret (32 characters: letters and digits)
Webhook Secret Webhook Secret (64 characters: letters and digits)
Endpoint URL yourstore.myshopify.com

All values are entered directly in the SmartConsign portal.

Shopify App Configuration

Access the Dev Dashboard

⚠️ Important – Legacy Private Apps Deprecated: As of 1 January 2026, Shopify no longer allows new legacy private apps to be created from the store admin. All new apps must be created through the Shopify Dev Dashboard. If you have an existing legacy private app it will continue to work and is unaffected by this change.

A Shopify app is required to allow SmartConsign to access your store data and fulfill your order.

  1. Log in to your Shopify Admin.
  2. Go to Settings → Apps.
  3. Click Develop apps.
  4. Click Build apps in Dev Dashboard. This opens the Dev Dashboard in a new tab.

Create an App

  1. In the Dev Dashboard, click Create app.
  2. Under the Start from Dev Dashboard section, give your app a name (e.g. SmartConsign Integration).
  3. Click Create.

Note Your Client ID and Client Secret

  1. Inside your newly created app, go to Settings.
  2. Copy and securely store your Client ID and Client Secret. These map to the API Key and API Secret Key fields in SmartConsign.

You will need these values when creating the SmartConsign channel within SmartConsign to link the app.

Configure your app

Within the Home tab of your app, click New version.

  1. Under Access, Add the following scopes:

read_all_orders,read_assigned_fulfillment_orders,write_assigned_fulfillment_orders,read_merchant_managed_fulfillment_orders, write_merchant_managed_fulfillment_orders,read_orders,write_orders,read_third_party_fulfillment_orders,write_third_party_fulfillment_orders

  • Orders
  • Fulfilment services
  • Merchant-managed fulfilment orders
  1. Under URLs, set the following:

App URL: https://shopify.dev/apps/default-app-home Uncheck Embed app within Shopify Admin

  1. Then click Release and then Release again to confirm.

Install the App

  1. After releasing the app, click Install app on the Home tab, then select your store that matches the URL of the store you are adding to SmartConsign.

Configure Webhooks

SmartConsign uses Shopify webhooks to receive order events.

  1. In Shopify Admin, go to Settings → Notifications
  2. Scroll down to Webhooks and click Create webhook
  3. In the opened window, configure the webhook as follows:
  • Event: Order Payment (default and recommended)
  • Format: JSON
  • URL:
    https://shopify.smartconsign.io/api/ShopifyWebhook
  • Webhook API Version: Latest
  1. Save the webhook

After saving, copy and store the Webhook Secret — this must be entered in the SmartConsign portal.

Setting Up the Shopify Integration within SmartConsign

Step-by-step

  1. Log in to the SmartConsign Portal
  2. Navigate to
    Channels → Manage Channels
  3. Locate Shopify and click Add Integration
  4. A new window will open
  5. Fill in all required fields with valid values
  6. Click Create Channel

That’s it 🎉 — the integration is now active.

Label & Shipment Management

Label creation and shipment processing are handled entirely in SmartConsign.

  • Orders import as Unallocated Shipments
  • The shipper selects carrier and service in SmartConsign
  • Labels are generated manually
  • Tracking automatically fulfils the order in Shopify
  • Shopify timelines remain unchanged

Cancelling or modifying shipments is managed in SmartConsign and may depend on carrier rules.

For standard Shopify order actions, refer to:

https://help.shopify.com/en/manual/orders

What is an Unallocated Shipment?

An unallocated shipment means:

  • No carrier or service is assigned automatically
  • No label is generated
  • The data is imported without allocating the courier, courier service or producing the shipping label.
  • The user completes shipment details and generates the label in SmartConsign
  • The order is then Fulfilled in Shopify with tracking information once the label is created in SmartConsign. This will take a few minutes.

Support

If your Shopify environment has specific requirements or you need assistance, please contact your SmartConsign setup provider or support team.