Set upHow-toPart 2 of 5 in this journey

Connect Shopify to StoreFulfil

Install StoreFulfil Connect, or use a merchant-owned custom app when your warehouse requests that connection.

Which setup do I need?

StoreFulfil Connect links your Shopify store to the warehouse that fulfils your orders. The warehouse provides a connection code. You install the Shopify app, enter that code and select the warehouse's Shopify location.

If your warehouse instead sent a secure link asking for a Client ID and Client secret, use the custom-app instructions below. These are alternatives: you do not need to complete both.

Warehouse: provide the merchant's code

This part is for the warehouse administrator, not the Shopify merchant.

  1. In StoreFulfil, open Clients and select the brand whose store you are connecting.
  2. Open Settings → Shopify Connection.
  3. In the StoreFulfil Connect panel, choose Generate Shopify code. Copy the code shown in that session.
  4. Send the merchant the code and the installation link for your StoreFulfil Connect app. Tell them which Shopify location represents your warehouse.

Codes are one-time and expire. Use the latest code for this client. If you replace an existing connection, agree the change with the merchant first.

Where the warehouse creates the code

Warehouse view: Generate Shopify code appears above the store domain and location. Anonymised real screenshot.

Merchant: install StoreFulfil Connect

Use a Shopify account allowed to install apps on the intended store. Have your warehouse's connection code ready.

  1. Open the app installation link your warehouse supplied. If Shopify asks you to choose a store, select the store this warehouse will fulfil.
  2. Check the app name and developer, review Shopify's requested access, then choose Install.
  3. When Shopify returns you to the admin, open Apps → StoreFulfil Connect, or the warehouse-branded app named in your instructions.
  4. You should see Link to your warehouse. Continue with the code below.

You do not need the Dev Dashboard, API keys or a second custom app for this installation. If you cannot approve the app, ask the store owner to install it or grant the appropriate Shopify permissions.

Warehouse: check the connection before starting work

The merchant's Connected message means the store and location are linked. It does not mean that orders are ready to pick.

  • Return to the same client's Settings → Shopify Connection screen.
  • Check the connected .myshopify.com domain and the displayed Shopify location against the merchant's store and your physical warehouse.
  • Review Connection Health and any setup messages. Resolve missing access or location issues before processing orders.
  • Allow the initial order and inventory import to finish. Review its result and check the client's records in StoreFulfil rather than assuming an empty queue means setup failed.

StoreFulfil manages the connection's supported webhook setup. The merchant does not need to register those webhooks manually. Shopify orders assigned to another location are not automatically work for this warehouse.

The connection supports order, product, inventory and return synchronisation, plus the Shopify updates made by supported warehouse actions. Individual orders still follow the warehouse's fulfilment checks.

Alternative: connect a merchant-owned custom app

Follow this route only when the warehouse supplied a secure custom-app setup link. The app must belong to the same Shopify organisation as the target store. A warehouse administrator's unrelated app credentials will not work for this connection.

Before you start

  • Have the secure setup link for the correct store and its permanent .myshopify.com domain.
  • Use an account with app development permissions in the merchant's Shopify organisation, such as the App developer role.
  • Confirm the Shopify location this warehouse will operate.

Create the app

  1. From Shopify, open Settings → Apps → Develop apps → Build apps in Dev Dashboard. You can also open the Dev Dashboard directly.
  2. Check the selected organisation. Choose Create app → Start from Dev Dashboard, enter the name requested by your warehouse and choose Create.

Configure and release the app

  1. Open Versions and create a version.
  2. Enter the App URL specified by the warehouse. For a non-embedded app, Shopify supports https://shopify.dev/apps/default-app-home.
  3. Choose the Webhooks API version specified in the warehouse's setup instructions.
  4. Enter the complete scope list below and choose Release. Confirm the release if Shopify prompts again.
Custom-app Admin API scopes
read_orders,read_returns,write_returns,read_locations,read_products,read_merchant_managed_fulfillment_orders,write_merchant_managed_fulfillment_orders,read_inventory,write_inventory

Use the full list. Ordinary StoreFulfil Connect installations do not require you to enter scopes.

If permissions are changed after installation, the merchant must approve the updated access in Shopify. Saving or releasing new scopes is not the same as granting them.

Install the custom app

  1. Open the app's home page and choose Install app from the Installs card.
  2. Select the intended store, review the requested permissions and choose Install.

Enter credentials in the secure setup page

  1. In the Dev Dashboard app, open App settings to find its Client ID and Client secret.
  2. Open the warehouse's secure setup link and check the store domain. Enter the credentials directly into that page.
  3. Complete its verification and Shopify location selection. Let the warehouse review the connection and initial sync result.

StoreFulfil obtains and refreshes the short-lived Shopify access token. You do not need to find a permanent Admin API token in Shopify. Do not send the Client secret through email or chat.

If you get stuck

What you seeWhat to do
You cannot install the appAsk the Shopify store owner to approve installation or check your app-management permissions.
The code is invalid or expiredCheck for a typing error and use the latest code. If it has expired or been used, ask the warehouse for a new code for this client.
The warehouse or brand is wrongDo not submit. Return to code entry and ask for the code belonging to the intended warehouse and client.
No active Shopify locations are listedAsk the merchant and warehouse to check Shopify Settings → Locations. Do not choose an unrelated location just to continue.
You are asked to replace a connectionConfirm the intended change with the warehouse. Replacement is not a harmless retry.
Connected, but orders are missingThe warehouse should check the store, mapped Shopify location, permissions and initial import. Orders at another location may be outside this warehouse's work.
The custom-app setup link will not openAsk the warehouse for a fresh secure link. Do not paste its full URL or credentials into a support ticket.

Keep the connection safe

Do not share Client secrets, access tokens or complete secure setup links in screenshots or support messages. For help, provide the store domain, the screen title and the error message without credentials or connection codes.

Do not disconnect or reinstall a working connection as your first troubleshooting step. Ask the warehouse to review it before changing the link between the store and its fulfilment location.

Check your result

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

Admin details: states, evidence and hand-off

Owner: Integration Engineering. Area: Integrations. Action owner: Merchant with Shopify installation permissions; Warehouse Admin for client setup and location mapping. A custom app additionally needs a permitted app developer..

What you might see

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.

When to ask for help

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

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

  • The intended client and Shopify store are known to the warehouse.
  • A Shopify user can review and approve the installation on the intended store.
  • For the custom-app path only, an app developer can create the app in the merchant's Shopify organisation.

Sources

© 2026 STOREFULFIL PTY LTD (ACN 701 718 649 · ABN 98 701 718 649), Queensland, Australia · StoreFulfil Operations Library.