This guide connects your Shopify store to Ringly with a custom app you make in Shopify. You only copy and paste a few values.

You need access to your Shopify admin with permission to develop apps. Store owners have this by default.

Step 1: Open the Dev Dashboard

In your Shopify admin, click Settings (bottom left), then Apps, then Develop apps (top right). Shopify opens the Dev Dashboard.

Shopify admin, Settings, Apps page. Apps in the left menu (1) and the Develop apps button at the top right (2) are marked.

Step 2: Create the app

In the Dev Dashboard, click Apps, then Create app.

Shopify Dev Dashboard, Apps page. Apps in the left menu (1) and the Create app button at the top right (2) are marked.

Fill in the form:

App name: Ringly
App URL: https://app.ringly.io/
Important: untick Embed app in Shopify admin.
Allowed redirection URL(s): https://app.ringly.io/onboarding-2?custom=true
Scopes: paste this list:

read_assigned_fulfillment_orders, read_customer_events, read_customers, read_draft_orders, write_draft_orders, read_fulfillments, read_inventory, read_order_edits, read_orders, read_products, read_product_listings, write_returns, write_orders, read_discounts, read_returns, read_shipping

Leave the other fields as they are and click Create app (top right). Shopify then asks you to release the first version. Leave the description empty and click Release.

The Create an app form filled in, with its five fields numbered: App name (1), App URL (2), the Embed app in Shopify admin checkbox unticked (3), Allowed redirection URL(s) (4) and Scopes with the full list pasted (5). The Create app button at the top right is marked.

Step 3: Install the app on your store

Open your app's Overview tab and click Test app in the Installs box. On some accounts it says Install app.

Shopify Dev Dashboard, the app's Overview tab (1) and the Test app button in the Installs box (2).

If Shopify asks which store, pick yours. Then click Install. Shopify warns that the app hasn't been reviewed. That's normal for an app you make yourself.

Step 4: Copy your client ID and secret

Back on the same Overview tab, find the Credentials box. Copy the Client ID and the Client secret with the copy buttons.

The Credentials box in the Dev Dashboard with the Client ID and Client secret. The copy button next to each is marked.

Keep the secret private, and don't click Rotate: that disconnects your store from Ringly.

Step 5: Connect the store in Ringly

In Ringly, open your Seth. Until Shopify is connected, the Shopify card sits at the top of every tab. You also find it on the Integrations tab. Click Connect.

Ringly, Seth's Integrations tab. The Shopify card with the Connect button marked.

Under Paste from Shopify, fill in:

Your store: your store's web address, like yourstore.com. Your myshopify address or the link to your Shopify admin works too.
Client ID: the client ID you copied.
Client secret: the client secret you copied. It starts with shpss_.

Under Your store, Ringly shows Found with your store's name and its myshopify address. Then click Connect store.

The Shopify card opened in Ringly. Your store (1) with the Found line under it, Client ID (2), Client secret (3) and the Connect store button (4) are marked.

When it worked, the card shows Connected with your store's name and web address.

The Shopify card in Ringly after connecting, with the Connected badge marked.

Already have a store in Ringly that no Seth uses? The card shows it with Use this store. To connect a different store, click Connect another store.

Connecting Shopify while you sign up? On the Shopify step, click Use a custom app instead to get the same fields.

Step 6: Turn on the skills you want

Open Seth's Train tab and go to Using skills. Look up an order is on once Shopify is connected. Switch on the other Shopify skills you want Seth to use, like Request a return or Place orders.

Seth's Train tab, Using skills section, with the built-in skills Look up an order, Request a return, Request order cancellation, Place orders and Email a support ticket. The on and off switches are marked.

Seth also loads your product catalog by itself, so there is nothing to sync.

If something doesn't work

Check that the App URL is exactly https://app.ringly.io/ and that Embed app in Shopify admin is unticked.
Ringly says No Shopify store at your address? Check the spelling, or paste the link to your Shopify admin instead.
Ringly says Shopify didn't accept this client ID and secret? Check that the app is installed on that store (step 3), then copy both again with the copy buttons.
Did the connection stop working later? Refresh it with your client ID and secret.

How to connect Shopify to Ringly with a custom app