Prerequisites
Admin access to your Shopify store
Admin access to Luminous
Step 1: Create a Custom App in Shopify
Log into your Shopify Admin.
Click Settings (bottom-left).
Go to Apps and sales channels.
Click Develop apps.
Click Build apps in Dev Dashboard.
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
Click Create app.
Name the app (example:
Luminous IntegrationorLuminous).Click Create app.
Once created, you’ll be taken to the app configuration screen.
Step 3: Configure API Scopes
Scroll to the Access section.
Find the section here labeled scopes.
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_inventorywrite_inventory
Locations
read_locationswrite_locations
Products
read_productswrite_productsread_product_feedswrite_product_feedsread_product_listingswrite_product_listings
Orders
read_orderswrite_ordersread_draft_orderswrite_draft_ordersread_order_editswrite_order_edits
Fulfillments
read_fulfillmentswrite_fulfillmentsread_assigned_fulfillment_orderswrite_assigned_fulfillment_ordersread_merchant_managed_fulfillment_orderswrite_merchant_managed_fulfillment_orders
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,write_orders,read_product_feeds,write_product_feeds,read_product_listings,write_product_listings,read_products,write_products
Step 4: Disable Embedded App Setting
Scroll to the URLs section.
Untoggle:
Embed app in Shopify admin.
Step 5: Release the App
Click Release (top-right corner).
Ignore the optional rename prompt.
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
From the app’s home page, find the Install app box on the right.
Click Install app.
Select the correct Shopify store.
Review the permissions list to confirm the scopes.
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
Open the app you just installed in the dev dashboard (this can be found by clicking Build Apps in dev dashboard.
Go to Settings.
Copy the following:
Client ID
Client Secret
Keep these handy—you’ll paste them into Luminous next.
Step 8: Add Shopify Integration in Luminous
Log into Luminous.
Click your name (bottom-left).
Go to Integrations.
Click New App Account (top-right).
Set App Type to
Shopify.
Fill in the Fields
Client ID → paste from Shopify
Client Secret → paste from Shopify
Admin Access Token → leave blank (auto-fills later)
Step 9: Find Your Store Slug
Go to your Shopify store admin (not the Dev Dashboard).
Look at the URL:
Copy everything between
/store/and/settings.Paste this into the Store Slug field in Luminous.
Add a label if desired (example: Main Shopify Store).
Step 10: Configure Integration Settings
Under Settings in Luminous:
Toggle Get Products ✅
Toggle Show Inventory Locations ✅
Click Test Credentials.
Expected Result
✅ Credentials are valid and all required scopes are available
Step 11: Save & Verify
Click Save to complete setup.
Refresh the integration.
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