Shopify

Connect Shopify to your Workspace to bring your store’s orders, products, customers, and inventory into Luo — log them, display them, build dashboards, or hand them off to the assistant for analysis.

What Luo can do

  • Read products and product variants, including price, inventory, and tags
  • Read orders with line items, addresses, financial status, and fulfillment status
  • Read draft orders
  • Read customer profiles and default addresses
  • Search using Shopify’s search syntax (e.g. created_at:>=2026-01-01 financial_status:paid)
  • Run arbitrary read-only GraphQL queries when the typed functions don’t cover a field

Shopify in Luo is read-only today. Writes (create/update/fulfill/cancel) are not yet supported.

How to connect

You’ll create a custom app in the Shopify Dev Dashboard, configure permissions, and then paste the app’s Client ID and Client secret into Luo. Luo runs the OAuth handshake against your shop using your own app credentials.

1. Create the app

  1. Open the Shopify Dev Dashboard at dev.shopify.com/dashboard and sign in.
  2. In the left-hand menu, click Apps.
  3. Click Create app, enter a name (e.g. Luo Connector), and confirm.

2. Fill in the Versions menu

You land on the Versions menu. Fill in these fields, top to bottom:

URLs section

  • App URL:

    https://luo.app
    
  • Embed app in Shopify admin — leave this checkbox unticked. Luo connects to your shop through the API; it doesn’t render inside the Shopify admin UI.

Access section

  • Scopes — paste this comma-separated list:

    read_products,read_orders,read_customers,read_inventory,read_draft_orders
    
  • Use legacy install flow — tick this checkbox. (Luo runs a standard OAuth handshake, which is what the legacy flow provides.)

  • Redirect URLs — paste Luo’s OAuth callback (the field accepts a comma-separated list, but you only need this one):

    https://platform.prd.luo.app/oauth/shopify/callback
    

Once all four fields are filled in, release the version.

3. Set up Custom Distribution and install the app

You may be able to skip this step. Click your app’s name in the left-hand menu to return to the app overview, then look at the right-hand side. If there’s no Distribution card, your app is ready to use as-is — skip ahead to step 4. If the Distribution card is present, follow the steps below.

  1. In the left-hand menu, click your app’s name (e.g. Luo Connector) to return to the app overview.
  2. On the right-hand side, find the Distribution card and click Select distribution method.
  3. Choose Custom distribution.
  4. Untick “Allow multi-store install for [your organization]” — you only want this app installable on your one shop.
  5. Enter your shop URL (e.g. luo-technologies.myshopify.com) and click Generate link.
  6. Copy the generated install link and open it in a new browser tab.
  7. On the page that opens, select the correct store if prompted, then confirm. Shopify completes the install and redirects you to Luo — there’s no separate success screen. You can close that tab once you’re back in Luo. Also close the previous Shopify tab and return to the Shopify dev dashboard tab.

If the Distribution card was there, you must complete the install step before connecting in Luo. OAuth from Luo’s “Connect” button can’t complete until the app has been installed on the shop at least once.

4. Copy the Client ID and Client secret

In the left-hand menu, click Settings. In the Credentials card, copy:

  • Client ID
  • Secret (this is the Client secret — the dashboard just labels it “Secret”)

5. Connect Shopify in Luo

  1. Open your workspace in Luo.
  2. Go to Settings and select the Integrations tab. Click Add Integration.
  3. Select Shopify.
  4. Choose to connect either as a user integration (your personal connection) or a workspace integration (shared across workspace members).
  5. Paste:
    • Shop subdomain — the part before .myshopify.com in your shop URL (e.g. mystore for mystore.myshopify.com). Pasting the full URL works too.
    • Client ID — from step 5.
    • Client secret — from step 5.
  6. Click Continue. Luo redirects you to Shopify to authorize the app, then returns you to Luo with the integration connected.
  7. Click Create Integration

Adding new permissions later

If you ever need Luo to do something that requires a scope you didn’t enable at install:

  1. Back in the Dev Dashboard, add the extra scopes to the Access section under Versions and save a new version.
  2. Reinstall the app on your shop, then reconnect Shopify in Luo. This invalidates your existing authorization — you’ll re-run the OAuth handshake.

Privacy and data handling

Your custom app belongs to your shop. Shopify doesn’t require app store review or Protected Customer Data approval for custom apps — they’re treated as “Always available” because the merchant owns the app.

Data that flows through Luo is governed by Luo’s security and privacy practices. If you ever want to revoke Luo’s access, uninstall the custom app from your shop — that immediately invalidates the access token.