Connect Your Shopify Store to Stoked (Custom App)

A step-by-step guide to connect your Shopify store to Stoked using a custom app you create in your own Shopify account. It takes about 10 minutes, and you only do it once.

Why a custom app?

While Stoked’s listing in the Shopify App Store is being reviewed, you can connect your store right away by creating a small custom app inside your own Shopify account and sharing its credentials with Stoked. You stay in full control — you create it, you choose exactly what it can access, and you can remove it at any time.

You only do this once. After your store is connected, you never have to think about it again.

Step 1: Create the app in your Shopify Dev Dashboard

  1. Go to dev.shopify.com/dashboard and sign in with your Shopify account.
  2. In the left menu, select Apps, then click Create app.
  3. Choose Start from Dev Dashboard.
  4. Give the app a name you’ll recognize — for example, Stoked Connection — and click Create.

As of January 1, 2026, you can no longer create custom apps from your store admin (Settings > Apps). The Dev Dashboard above is the current way to create one.

Step 2: Add the required permissions

On the Versions tab, under App scopes (Admin API access scopes), paste this exact comma-separated list (use the copy button in the corner), then click Release:

read_orders,write_orders,read_discounts,write_discounts,read_store_credit_accounts,read_store_credit_account_transactions,write_store_credit_account_transactions

These permissions let Stoked create discount codes for your advocates, attribute orders to the right advocate, and issue store credit as rewards. Stoked never changes your products, pricing, or customers.

This is a backend connection with no admin screen, so on the same page you can leave the App URL as its default and the Redirect URLs blank, and uncheck “Embed app in Shopify admin.” Only the scopes above matter.

The three …store_credit… scopes are for future reward payouts. If Shopify shows a lock or Request access next to any of them and won’t let you release, leave those three off and paste just read_orders,write_orders,read_discounts,write_discounts instead — that’s all that’s needed to connect and attribute orders. You can add store credit later.

Step 3: Install the app on your store

  1. Select Home in the left menu, then scroll down and click Install app.
  2. Choose your store from the list.
  3. Click Install.

Step 4: Copy your API credentials

  1. Open the app’s Settings.
  2. Find the Client ID (sometimes labeled “API key”) and the Client secret (sometimes labeled “API secret key”).
  3. Keep this page open — you’ll paste both values into Stoked in the next step.

Treat your Client secret like a password — don’t post it in chat or email. You’ll paste it directly into Stoked, where it’s stored encrypted and never shown again.

Step 5: Connect in Stoked

  1. In Stoked, go to Settings > Shopify.
  2. Fill in:
    • Shop Domain — your store address, e.g. your-store.myshopify.com
    • API Key (Client ID) — the Client ID you copied
    • API Secret Key (Client Secret) — the Client secret you copied
  3. Click Connect to Shopify.

What success looks like

After connecting, the page updates to show your store name, domain, and a “Connected” status, with quick links to your Shopify admin. That’s it — your store is connected, and you can turn on the features you want from the Features card.

If you see an error, double-check that you copied the Client ID and Client secret exactly, that the app is installed on the right store, and that every permission in Step 2 was added before you clicked Release.

Hit a snag? Reach out to the Stoked team and we’ll get you connected.

© 2024-2026 Stoked — Real conversations. Real trust.