Prerequisites

  • Admin access to your Shopify store
  • Admin access to Luminous

Step 1: Create a Custom App in Shopify

  1. Log into your Shopify Admin.
  2. Click Settings (bottom-left).
  3. Go to Apps and sales channels.
  4. Click Develop apps.
  5. Click Build apps in Dev Dashboard.
  6. This will take you to a new tab with the Dev Dashboard.

You’ll now see a list of apps you’ve created (or an empty list if this is your first one).

Step 2: Create the App

  1. Click Create app.
  2. Name the app (example: Luminous Integration or Luminous).
  3. Click Create app.

Once created, you’ll be taken to the app configuration screen.

Step 3: Configure API Scopes

  1. Scroll to the Access section.
  2. Find the section here labeled scopes.
  3. Paste a comma-separated list here (provided in this documentation below).

⚠ Make sure the scopes are comma-separated.

Required Scopes

Add all of the following scopes to your Shopify app. These permissions allow Luminous to sync products, inventory, orders, fulfillments, and tracking updates correctly.

Easy-to-Read Scope List

Inventory

  • read_inventory
  • write_inventory

Locations

  • read_locations
  • write_locations

Products

  • read_products
  • write_products
  • read_product_feeds
  • write_product_feeds
  • read_product_listings
  • write_product_listings

Orders

  • read_orders
  • read_all_orders
  • write_orders
  • read_draft_orders
  • write_draft_orders
  • read_order_edits
  • write_order_edits

Fulfillments

  • read_fulfillments
  • write_fulfillments
  • read_assigned_fulfillment_orders
  • write_assigned_fulfillment_orders
  • read_merchant_managed_fulfillment_orders
  • write_merchant_managed_fulfillment_orders
  • write_metaobjects, read_metaobjects

Copy‑Paste (Comma‑Separated) Scope List

Paste the following exactly as-is into Shopify’s Admin API access scopes field:

read_assigned_fulfillment_orders,write_assigned_fulfillment_orders,write_draft_orders,read_draft_orders,read_fulfillments,write_fulfillments,write_inventory,read_inventory,write_locations,read_locations,read_merchant_managed_fulfillment_orders,write_merchant_managed_fulfillment_orders,write_order_edits,read_order_edits,read_orders,read_all_orders,write_orders,read_product_feeds,write_product_feeds,read_product_listings,write_product_listings,read_products,write_products,write_metaobjects,read_metaobjects

Step 4: Disable Embedded App Setting

  1. Scroll to the URLs section.
  2. Untoggle: Embed app in Shopify admin.

Step 5: Release the App

  1. Click Release (top-right corner).
  2. Ignore the optional rename prompt.
  3. Wait for the app to finish releasing.

You may see version numbers appear—these can be ignored.

Step 6: Install the App on Your Store

  1. From the app’s home page, find the Install app box on the right.
  2. Click Install app.
  3. Select the correct Shopify store.
  4. Review the permissions list to confirm the scopes.
  5. Click Install.

You can close out of the confirmation page afterward.

✅ To verify installation, the install count should change from 0 to 1.

Step 7: Copy Shopify API Credentials

  1. Open the app you just installed in the dev dashboard (this can be found by clicking Build Apps in dev dashboard.

  2. Go to Settings

  3. Copy the following:

    • Client ID
    • Client Secret

Keep these handy—you’ll paste them into Luminous next.

Step 8: Add Shopify Integration in Luminous

  1. Log into Luminous.
  2. Click your name (top-right).
  3. Go to Settings / Integrations.
  4. Click + Add Integration (top-right).
  5. Select Shopify, then choose Direct connection.

Fill in the Fields

  • API Key / Client ID → paste from Shopify
  • Client Secret (Optional - New Method) → paste from Shopify (click Show 10 settings you can adjust after connecting to reveal it)
  • Admin Access Token (Legacy) → leave blank (auto-fills later)

Step 9: Find Your Store Slug

  1. Go to your Shopify store admin (not the Dev Dashboard).

  2. Look at the URL:

    Example: https://admin.shopify.com/store/{store-slug}/settings

  3. Copy everything between /store/ and /settings.

  4. Paste this into the Store Slug field in Luminous.

Add a label if desired (example: Main Shopify Store).

Step 10: Configure Integration Settings

In the expanded settings (Show 10 settings you can adjust after connecting):

  • Toggle Get Products ✅
  • Toggle Show Inventory Location ✅

Click Test connection.

Expected Result

✅ Credentials are valid and all required scopes are available

Step 11: Save & Verify

  1. Click Save to complete setup.
  2. Refresh the integration.
  3. Click the pencil icon (edit).

You should now see:

  • Admin Access Token auto-filled
  • Credentials still passing when re-tested

✅ Setup Complete

Your Shopify store is now successfully connected to Luminous.

  • Orders will sync
  • Tracking numbers will update
  • Inventory locations are available

If you run into issues or have questions, reach out to the Luminous team for support.

Loom Walkthrough