Setup Guide

Connect Shopify to WebShip

Create a custom Shopify app and link it to your WebShip account using OAuth authentication in just a few minutes.

Part 1

Create a Custom App in Shopify

1

Search for "Apps"

In your Shopify admin panel, use the search bar at the top and type "Apps". From the dropdown results, click App settings.

Search for Apps in Shopify admin

Click "App settings" from the search results

2

Open the Apps Page

You'll land on the Apps page in your Shopify settings. Click the "Develop apps" button in the top-right corner.

Shopify Apps page with Develop apps button

Click "Develop apps" in the top-right corner

3

Enter the Dev Dashboard

On the App development page, click "Build apps in Dev Dashboard".

Do not use "Build legacy custom apps" — legacy custom apps have been deprecated by Shopify as of January 2026.
App development page

Click "Build apps in Dev Dashboard" (not the legacy option)

4

Create a New App

In the Shopify Dev Dashboard, click the "Create app" button in the top-right corner.

Dev Dashboard - Create app button

Click "Create app" in the Dev Dashboard

5

Name Your App

On the "Create an app" page, choose "Start from Dev Dashboard" on the right side. Enter an app name (e.g., "WebShip") in the App name field, then click Create.

Name your app and click Create

Enter a name under "Start from Dev Dashboard" and click Create

Part 2

Configure App Scopes (Permissions)

6

Scroll Down to Access

Once the app is created, scroll down to find the Access section. You'll see fields for Scopes, Optional scopes, and Redirect URLs.

Access section with scopes fields

The Access section where you'll configure permissions

7

Enter the Required Scopes

Click into the Scopes text field and paste the following scopes, separated by commas, all on one line. Copy each scope from the list below and paste them into the field one after another, separated by a comma.

These scopes give WebShip the ability to read and manage orders, shipping, fulfillment, inventory, and channels on your behalf.
read_assigned_fulfillment_orders write_assigned_fulfillment_orders read_channels write_channels read_custom_fulfillment_services write_custom_fulfillment_services read_fulfillments write_fulfillments write_inventory read_inventory read_merchant_managed_fulfillment_orders write_merchant_managed_fulfillment_orders read_orders write_orders read_shipping write_shipping read_third_party_fulfillment_orders write_third_party_fulfillment_orders
Having trouble pasting? You can also click the "Select scopes" link to the right of the Scopes field. This opens a searchable list where you can find and check each scope individually.
Scopes field filled in

After pasting, your Scopes field should look like this

Part 3

Release & Install the App

8

Click Release

After configuring your scopes, look for the "Release" button in the top-right area of the page and click it to create a version of your app.

Click the Release button

The Release button at the top of the page

9

Confirm the Release

A dialog will appear asking "Release this new version?". The version name and message fields are optional — you can leave them blank. Click Release to confirm.

Release confirmation dialog

Optionally name the version, then click Release

10

Click Home

After the release completes, you'll land on the Versions page. Click Home in the left sidebar to go to the app overview.

Click Home in the sidebar

Click "Home" in the left sidebar

11

Install the App

On the app Home page, find the Installs section in the top-right and click "Install app".

App home page with Install button

Click "Install app" from the Home page

12

Confirm Installation

A confirmation dialog shows the permissions the app needs. Review the access list, then click Install.

Install app confirmation dialog

Review the permissions and click Install

Part 4

Copy Your App Credentials

13

Go to Settings

In the left sidebar of the Dev Dashboard, click Settings under your app name.

Dev Dashboard sidebar with Settings

Click Settings in the sidebar

14

Copy Your Client ID and Secret

On the Settings page, you'll see your app Credentials:

Keep both values handy — you'll paste them into WebShip in the next step.
Settings page showing Client ID and Secret

Copy your Client ID and reveal + copy your Secret

Part 5

Connect to WebShip

15

Open WebShip Admin

Log in to your WebShip account. Click the Admin tab in the top navigation, then click the Ecommerce Integrations tab. Click "Add Integration".

WebShip Admin - Ecommerce Integrations

Navigate to Admin > Ecommerce Integrations > Add Integration

16

Choose Shopify & Select OAuth

In the Create Ecommerce Integrations dialog, select Shopify as the Channel Type, enter a nickname and your store URL, then select OAuth (Recommended) as the authentication type.

Create integration dialog - choose Shopify and OAuth

Select Shopify, enter your store details, and choose OAuth

17

Paste Credentials, Activate & Save

Fill in the form with the credentials you copied from Shopify:

FieldWhat to Enter
Channel TypeShopify
NicknameA friendly name for this store (e.g., "My Store")
UrlYour Shopify store URL, e.g. https://mystore.myshopify.com
Authentication TypeOAuth (Recommended)
Shopify Client IdPaste the Client ID from Step 14
Shopify Client SecretPaste the Secret from Step 14
ActivateCheck this box

Click Save to complete the integration.

The URL must contain myshopify.com. You can find your store URL in Shopify admin under Settings > Domains.
Completed integration form with credentials

Paste your credentials, check Activate, and click Save

You're All Set!

Your Shopify store is now connected to WebShip via OAuth. Orders will automatically sync for shipping and fulfillment.