Skip to content
Open Ruit

Connect your Shopify store to RUIT

Connect Shopify to RUIT: create the app in the Dev Dashboard, paste in the eight scopes, install it on your store and copy its two keys across.

Difficulty: Medium 7min read

In this tutorial you connect your Shopify store to RUIT. There are two parts: first you create an app inside your own store, then you paste its two keys into RUIT. It takes five minutes and you do it once only.

You need to be the store owner, or to have the app-development permission if you are a member of the team. Any store will do, development stores included. At no point does RUIT ask you for your Shopify password: you define the permissions yourself and you can withdraw them whenever you like.

1. Open the Dev Dashboard

Go to dev.shopify.com with the same account you manage your store with. You will see your organization’s list of apps and, top right, Create app.

The list of apps in the Shopify Dev Dashboard, with the search-by-name box and the create-app button at the top right

The list of apps. If this is your first time it will be empty and you will see a terminal command: ignore it, it is for people who write apps. The button you want is Create app.

2. Create the app and give it a name

Press Create app, type a name you will recognize and confirm. The name is just for you.

The create-an-app screen in the Dev Dashboard, with the name field and the create button

Any name will do. In the figures in this guide it is called RUIT.

3. Paste in the eight scopes

Shopify leaves you on the version screen. Find the API access section and, in the Scopes field, paste this list exactly as it is:

read_products,write_products,read_inventory,write_inventory,read_locations,read_orders,read_publications,write_publications

There is also a button for ticking them one by one in a very long list, but pasting the list is quicker and you will not miss any. Leave every other field as it comes.

The `Scopes` field in the Dev Dashboard with the eight permissions pasted in as a comma-separated list

The eight permissions pasted in one go. Below the field there is a picker with checkboxes that does the same thing, one at a time.

ScopeRequired?What for
read_products and write_productsYesImporting, publishing and editing products
read_inventory and write_inventoryYesKeeping the stock in sync
read_locationsYesKnowing which warehouse to write that stock to
read_ordersYesHearing about sales at the time. Without it the connection is refused
read_publications and write_publicationsStrongly recommendedSo the product shows in your store and not only in the admin panel

4. Release the version

Press Release, top right, and confirm in the window that opens. The name and message it asks for are optional.

The window confirming the release of a new version of the app, with the optional name and message fields

This is the step people forget most. Without releasing the version, the keys in step 6 do not exist yet.

5. Install the app in your store

Go back to the app’s overview and press Install app. Pick your store and confirm on the permissions screen.

The app's overview in the Dev Dashboard, with the active version and the install-the-app button

The overview, with the version already released and the install button.

The installation screen inside the store's admin panel, with the permissions the app is asking for and the cancel and install buttons

Shopify warns you that the app has not passed its review. That is normal for a private app created in your own organization: nobody but you can install it, and the permissions are the ones you have just defined.

6. Copy the Client ID and the Client Secret

In the app’s settings, in the credentials section, you have both values. The secret stays hidden until you press the eye icon.

7. Connect the store in RUIT

Go to Settings → Accounts, press Connect Account and pick Shopify. It asks you for three things:

FieldWhat to paste
Store URLThe domain ending in .myshopify.com
Client IDThe one from step 6
Client SecretThe one from step 6

The address is the domain ending in .myshopify.com, not the domain you sell under publicly. RUIT is forgiving about copy and paste: it also accepts the address of the admin panel.

Video not recorded yet: Connecting a Shopify store

What you have achieved

Your Shopify store is connected to RUIT with keys that are yours and that you can revoke whenever you like. From here you can import the products you already have, publish the ones in your inventory, and RUIT hears about every sale as it happens.

Next step: importing from a marketplace to bring in what you already sell in that store.

If something is off

  • The connection fails saying permissions are missing. The error names which ones. Go back to step 3, paste the whole list into a new version of the app and release it; permissions travel with the version, so editing them without releasing changes nothing.
  • The product is created but does not show in the store. You are missing the two publication permissions. They are the ones that are not checked when you connect.
  • The connection fails saying the app is not installed. You skipped step 5, or you installed the app in another store.
  • You had an app from before 2026. It still works. Its keys are on its credentials tab inside the store’s admin panel, not in the Dev Dashboard.
  • A product runs out of stock. RUIT archives the product in Shopify rather than deleting it, so the history and the product’s address are kept.
View as Markdown

Did this article help?