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.
- In StoreFulfil, open Clients and select the brand whose store you are connecting.
- Open Settings → Shopify Connection.
- In the StoreFulfil Connect panel, choose Generate Shopify code. Copy the code shown in that session.
- 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
Merchant: install StoreFulfil Connect
Use a Shopify account allowed to install apps on the intended store. Have your warehouse's connection code ready.
- Open the app installation link your warehouse supplied. If Shopify asks you to choose a store, select the store this warehouse will fulfil.
- Check the app name and developer, review Shopify's requested access, then choose Install.
- When Shopify returns you to the admin, open Apps → StoreFulfil Connect, or the warehouse-branded app named in your instructions.
- 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.
Merchant: enter the code and choose the location
- On Link to your warehouse, enter the code exactly as supplied and choose Verify Code.
- Check the warehouse name and the Connecting as brand. If either is wrong, stop and ask the warehouse for the correct code.
- Under Select fulfillment location, select the Shopify location this warehouse operates. If only one location is available, check the preselected location before continuing.
- If an Existing connection detected message appears, confirm replacement only if that change has been agreed with the warehouse.
- Choose Submit. Wait for the Connected screen and check the warehouse and location shown there.
A Shopify location is not an internal pick bin. Select the physical fulfilment location for this warehouse, not an aisle, shelf, retail shop or another provider's location. Internal bins are managed separately in StoreFulfil Storage.
Enter the warehouse code
Select the Shopify location
Confirm the linked warehouse
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
- From Shopify, open Settings → Apps → Develop apps → Build apps in Dev Dashboard. You can also open the Dev Dashboard directly.
- 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
- Open Versions and create a version.
- Enter the App URL specified by the warehouse. For a non-embedded app, Shopify supports
https://shopify.dev/apps/default-app-home. - Choose the Webhooks API version specified in the warehouse's setup instructions.
- Enter the complete scope list below and choose Release. Confirm the release if Shopify prompts again.
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
- Open the app's home page and choose Install app from the Installs card.
- Select the intended store, review the requested permissions and choose Install.
Enter credentials in the secure setup page
- In the Dev Dashboard app, open App settings to find its Client ID and Client secret.
- Open the warehouse's secure setup link and check the store domain. Enter the credentials directly into that page.
- 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 see | What to do |
|---|---|
| You cannot install the app | Ask the Shopify store owner to approve installation or check your app-management permissions. |
| The code is invalid or expired | Check 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 wrong | Do not submit. Return to code entry and ask for the code belonging to the intended warehouse and client. |
| No active Shopify locations are listed | Ask the merchant and warehouse to check Shopify Settings → Locations. Do not choose an unrelated location just to continue. |
| You are asked to replace a connection | Confirm the intended change with the warehouse. Replacement is not a harmless retry. |
| Connected, but orders are missing | The 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 open | Ask 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.