How to set up BigCommerce in Starshipit
1. Create an API user in BigCommerce
- Before you can integrate with BigCommerce, create a user API account for BigCommerce. Ensure you select V2/V3 API token when creating the API account.
- Set the OAuth scopes.
Note: You only need to define the scopes listed below while leaving any other unlisted settings unchanged.
| Name | Scope |
|---|---|
| Content | modify |
| Checkout Content | modify |
| Customers | modify |
| Customers Login | login |
| Information & Settings | modify |
| Marketing | modify |
| Orders | modify |
| Order Transactions | modify |
| Create Payments | create |
| Get Payment Methods | read-only |
| Products | modify |
| Themes | modify |
| Carts | modify |
| Checkouts | modify |
| Sites & Routes | modify |
| Channel Settings | modify |
| Channel Listings | modify |
| Storefront API Tokens | manage |
| Storefront API Customer Impersonation Tokens | Manage |
Take note of the API Path, Client ID and Access Token supplied by BigCommerce as you will not be able to view your credentials again.
2. Copy the API information into Starshipit
Once you have generated the API credentials from BigCommerce, you need to enter your credentials in the Starshipit settings pages.
- In Starshipit, go to Settings > Integrations > Add a new integration > BigCommerce
- Choose a name that will help you to differentiate this store from your other BigCommerce stores
- Leave the Username field empty; it is not used by the integration that you are performing
- Complete API Path, Client ID, Access Token with the information from BigCommerce.
- Click on Save

3. Status to Update
You can select the status of the orders you wish to import using the following BigCommerce order status codes:
- Status 9 = Awaiting Shipment
- Status 11 = Awaiting Fulfillment
- Status 2 = Shipped [For Update Order]
- Status 10 = Completed [For Update Order]
See the entire list of order status codes.
4. Import your orders
- Click the Shipments tab at the top of the page in Starshipit.
- Once you are on the Shipments page, click the Import button, and select BigCommerce and the number of days you wish to import.
- Click Import at the bottom right.
- After a brief load time, the number of imported orders will be displayed.
- Click Close and your shipping page will reload with the newly imported orders.
Advanced settings and information
- Product Options: Starshipit will import the product options with the following display names:
- Size
- HS Code
- Color or Colour
- Pick up in Store: If you would like to use Starshipit for Pickup in Store orders select "Enable Pickup in Store". This setting enables any shipments printed with a Pickup In-Store carrier to have it's status updated to "Awaiting Pickup" upon Writeback
Manage multiple storefronts
How it works
When enabled, the Import Channel ID as a tag setting automatically tags the order with the Storefront ID when they are imported into Starshipit. This allows you to use Starshipit to manage multiple storefronts in BigCommerce seamlessly.
With this setting, you can:
- Filter orders
Use the orders grid to filter by specific store IDs - Create rules
Automate workflows using tags, e.g. "If Tag = [Storefront ID], assign to X account" or "Set carrier to X".
This rounds out our BigCommerce storefront offering, as we also support writeback for multi-storefront setups.
How to enable it
- Navigate to Settings > Integrations > BigCommerce.
- Scroll to the bottom of the page.
- Tick the checkbox for Import Channel ID as a Tag.