StoreFulfil Library

Connect a Shopify Store During the Multi-Store Pilot

The quickest secure setup for connecting each client store before the reviewed multi-merchant OAuth app is available.

How-to
Updated Aug 2026
Owner: Integration Engineering
Area: Integrations

Before you begin

Connect one client Shopify store securely and leave it ready for the first controlled synchronisation.

Prerequisites

  • The target client record exists in StoreFulfil.
  • A Shopify user with app development permissions can install the Shopify app; in a merchant organisation this is the App developer role.
  • The permitted Shopify user can enter the secret directly into the secure setup link.

Stop and check

Never send a Client secret through email, chat, tickets, or documents.

Why a Custom App?

During the multi-store pilot, each Shopify store uses an app created and owned inside that store's Shopify organisation. This keeps every merchant's credentials separate while the warehouse manages the operational relationship.

Before you start, you will need:

  • Access to the permanent store domain ending in .myshopify.com (not the public custom domain).
  • To have app development permissions in the target organisation. In a merchant organisation, the organisation owner or administrator can assign the App developer role.
  • The unique StoreFulfil setup link sent by your warehouse for this exact store.

Warehouse role

Creates your client record and sends the single-use setup link. The warehouse does not need your Client secret.

Shopify app developer role

With app development permissions, creates and installs the app, then enters its credentials directly into the secure StoreFulfil link.

1

Create the app in Shopify

Sign in to the Shopify Dev Dashboard with app development permissions. Navigate to Apps, select Create app, and choose Start from Dev Dashboard. Name the app StoreFulfil Connector, then select Create.

dev.shopify.com/dashboard

Apps

Create app
Create an app
StoreFulfil Connector
Cancel
Create
2

Configure app settings

Open the Versions tab and create a version. Define the app URL, select the newest Webhooks API version, and add the required Admin API scopes. Then select Release. If you change scopes after installation, Shopify requires the merchant to approve the new scopes manually.

dev.shopify.com/apps/storefulfil-connector/versions

App URL

For a non-embedded app, use the default Shopify App Home URL.

https://shopify.dev/apps/default-app-home

Admin API Scopes

Select the exact permissions required by StoreFulfil.

8 selected
read_orders
read_returns
read_locations
read_products
read_merchant_managed_fulfillment_orders
write_merchant_managed_fulfillment_orders
read_inventory
write_inventory
Release
3

Install on your store

From the app's Home page, scroll down and select Install app. Select or create the store for the app, review the requested permissions, and select Install.

dev.shopify.com/apps/storefulfil-connector/home

StoreFulfil Connector

Version released

Install app

Select or create the exact .myshopify.com store in your setup link.

Install
One app per storeCreate this app for the exact store named in your secure setup link. Do not reuse its Client ID or Client secret for another merchant or unrelated brand.
4

Securely connect to StoreFulfil

In the Shopify app, open Settings to locate your Client ID and Client secret. Then open the unique StoreFulfil setup link your warehouse sent and confirm that its displayed .myshopify.com domain is the same store. Enter both credentials there yourself.

Shopify Settings

8a9b2c3d4e5f6g7h8i9j0k1l2m3n4o5p
••••••••••••••••••••••••••••••••

StoreFulfil secure setup link

example-brand.myshopify.com
Paste secret here...

Keep the secret safe

Do not send the Client secret by email, chat, ticket, document, or screen share. Enter it directly into the StoreFulfil connection form over HTTPS. If the permitted Shopify user cannot complete this step, ask the organisation owner or administrator to grant the App developer role to the intended user instead.

StoreFulfil validates the app and encrypts the secret; it is never shown again.

Shopify’s current reference

Shopify updates its Dev Dashboard from time to time. If a label has changed, follow Shopify’s current guide for creating and releasing a Dev Dashboard app, then return here for the StoreFulfil scopes and secure connection step.

Open Shopify’s current app guide

Expected Outcome

The correct Shopify store is connected with store-specific credentials, mapped to the intended warehouse location, and ready for its first synchronisation.

Runbook evidence

Use these signals to decide whether the work is ready to continue, complete, or needs an owner.

State checkpoints

Not connected

No usable Shopify credential or location mapping is available.

Next: Complete the store-specific app setup and secure connection steps.

Healthy and mapped

The connection can read the store and has one intended warehouse location owner.

Next: Run the initial synchronisation and review its result.

Completion evidence

  • The intended store is healthy, mapped, and its initial sync result is visible.

Escalation evidence

  • Record the store domain, displayed health result, and failed step without sharing credentials.

Work safely

Who may take this action

Shopify user with app development permissions for app installation; Warehouse Admin for client setup and location mapping

What you should see

No usable Shopify credential or location mapping is available.

Safe next step

Complete the store-specific app setup and secure connection steps.

What not to do

Never send a Client secret through email, chat, tickets, or documents.

How to tell it is complete

The intended store is healthy, mapped, and its initial sync result is visible.