If you're using Shopify, here’s a quick and easy health check to make sure your integration is fully connected and that all fulfillment information is flowing correctly between Luminous ↔ Shopify.
Earlier this year, we released Fulfillment Orders, which require a few updated Shopify app permissions (scopes). Some accounts may still be missing these, which can cause issues with tracking or fulfillment syncing.
✅ How to Check Your Connection in Luminous
In Luminous, go to Your Name → Integrations
Select your Shopify connection
Click the ✏️ icon
Click Test Credentials
If you see a message such as “Missing required scopes”, you’ll need to update your custom Shopify app.
🛠️ How to Fix Missing Scopes in Shopify
Follow these steps to update the permissions (scopes) on your Shopify app:
Step 1 — Go to Your Shopify Settings
Open Shopify
Go to Settings → Apps and Sales Channels
Click Develop Apps
Select the custom app you created during Luminous implementation
Step 2 — Update Your App’s Scopes
Go to the Configuration tab
Click Edit
Compare your app scopes with the required Luminous scopes listed here:
In Luminous, go to Help & Tutorials
Search “Shopify”
Scroll to Configuring Admin Scopes for the full list
4. In your Shopify app, enable any missing scopes—these are usually the fulfillment-related ones, such as:
read_orders
write_orders
read_fulfillments
write_fulfillments
write_assigned_fulfillment_orders
write_merchant_managed_fulfillment_orders
Etc.
Step 3 — Save & Refresh
Save your updated scopes in Shopify
Return to Luminous and refresh your browser
Re-run Test Credentials
You should now see: “All required scopes are available”
That’s it! Once these scopes are updated, fulfillment data will flow smoothly between Shopify and Luminous.
🎥 Video Walkthrough
Here’s a quick tutorial showing the full process step-by-step:
👉 https://www.loom.com/share/79114ce1db3048eba4fda843933b4327
🧩 When to Use This
If you’re seeing issues such as:
Tracking not syncing
Fulfillments not returning to Shopify
Orders behaving unexpectedly
Start with this health check—it resolves most connection issues.
If everything looks good but you’re still experiencing problems, feel free to reach out to Support. We’re here to help! 💙