Help

Connect Shopify as a sales channel

Create a Shopify Dev Dashboard app, add the scopes and redirect URL, and paste your Client ID and Secret into Worldwatch to publish listings, sync inventory, and import orders.

Got a question about this guide? Use Open to continue it in Claude or ChatGPT.

Connecting Shopify lets Worldwatch publish your listings, sync inventory, and import your orders. You create a small app in Shopify's Dev Dashboard, give it the right permissions, and paste two credentials (a Client ID and Secret) into Worldwatch. It takes about ten minutes, and you only do it once.

Before you start

  • Your store's domain: the web address it's hosted on, for example vintagemasters.eu (your .myshopify.com address works too).
  • Admin access to your Shopify store, so you can open the Dev Dashboard and create an app.
  • About ten minutes.

Create the Shopify app

Log in to your Shopify admin

Go to https://admin.shopify.com/store/your-store-name and sign in with the store you want to connect.

Open Develop apps

In the sidebar, click Settings (bottom-left corner), then Apps, then Develop apps in the top-right corner. This opens Shopify's Dev Dashboard, where you build your app.

Shortcut: from any admin page you can also click your store name in the top-right, then the </> (View Dev Dashboard) icon.

Shopify store menu with the code-brackets View Dev Dashboard icon highlighted next to the store name.

Create an app

In the Dev Dashboard, open Apps in the left menu, then click Create app (depending on your view, it sits at the top-right or the bottom of the Apps page).

The Dev Dashboard Apps page with the Create app button highlighted.

Name the app

Under Start from Dev Dashboard, type WorldWatch Market as the app name and click Create.

The Create app dialog with WorldWatch Market typed into the app name field.

Add the access permissions (scopes)

Open your new app, go to Versions → Create version, and scroll to the Access section. In the Scopes box, paste this exact line, copy it as-is, commas and all:

read_products,write_products,read_orders,write_orders,read_inventory,write_inventory,read_customers

These seven permissions let Worldwatch read and update your products, orders, and inventory, and read the buyer's name and email address on an order. No payment data is accessed.

The Access section with the seven scopes pasted into the Scopes box.

Add the redirect URL

In the same section, scroll to Redirect URLs and paste this exact URL. It must match character-for-character, with no trailing slash:

https://app.worldwatch.market/dashboard/settings/channels/callback/shopify

The Redirect URLs field with the Worldwatch callback URL pasted in.

Release the version

Click Release in the top-right. A dialog asks for an optional version name and message. You can leave both blank and just click Release to confirm. Your scopes and redirect URL are now live.

The Release button in the top-right of the app version editor.

Install the app

Open your app (click its name in the top-left corner), then click Install app on the right. Do this before you copy your credentials; the keys of an app that isn't installed won't connect.

Copy your Client ID and Secret

In the app's left menu, click Settings. At the top, the Credentials card shows your Client ID and Secret. Copy both; for the Secret, click the eye icon to reveal it first. Keep the Secret private; if it ever leaks, use Rotate to generate a new one.

The Credentials card showing the Client ID and the hidden Secret, with reveal, copy, and Rotate buttons.

Connect it in Worldwatch

Open the Shopify connect panel

In Worldwatch, go to Settings → Channels → Connect Shopify and choose Client ID & Secret.

Fill in the three fields

Enter your Store domain, the web address your store is hosted on, for example vintagemasters.eu. You don't need the .myshopify.com address; your own domain works. Then add the Client ID (API key) and Client secret (API secret key) you copied.

Authorize

Click Authorize with Shopify and approve on the screen that opens. You're connected. Worldwatch can now publish listings, sync inventory, and import your orders.

Verify

On Settings → Channels, the Shopify tile shows Connected. Open a watch in Inventory → Manage watches, publish it to Shopify, and it appears as a product in your Shopify admin under Products.

Already selling on Shopify? Connecting doesn't copy your existing products into Worldwatch. To bring your current catalog in, see import your products from Shopify or WooCommerce.

Another way to connect: Admin API token

You can also connect with a Shopify Admin API access token instead of Client ID & Secret: install the app, copy its Admin API access token (it starts with shpat_), then in Worldwatch choose Admin API token and paste it.

This only works if your store already has a custom app. Shopify stopped allowing new custom apps to be created this way on 1 January 2026, so the Admin API token method applies only to stores that already have one. For a new connection, use the Client ID & Secret method above.

Troubleshooting

"Redirect URI mismatch" when authorizing

The redirect URL in your app must match exactly: https://app.worldwatch.market/dashboard/settings/channels/callback/shopify, with no trailing slash. Re-check it in the app's Access section, release a new version, and try again.

"Access denied" or a missing-scope error

Make sure all seven scopes are in the Scopes box: read_products,write_products,read_orders,write_orders,read_inventory,write_inventory,read_customers. Add any that are missing, release a new version, then reconnect.

The Secret is hidden

On the Credentials card, click the eye icon next to the Secret to reveal it before copying. If it ever leaked, click Rotate and update the new value in Worldwatch.

On this page