# How to integrate with BigCommerce
URL: https://support.starshipit.com/articles/204502815-how-to-integrate-with-bigcommerce
Canonical: https://support.starshipit.com/articles/204502815-how-to-integrate-with-bigcommerce
Markdown: https://support.starshipit.com/articles/204502815-how-to-integrate-with-bigcommerce.md
Updated: 2026-05-06

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Learn how to integrate Starshipit with BigCommerce to import your orders and ensure tracking information is written back when you print a label.

Connect BigCommerce to Starshipit to import orders and write back tracking details when labels are printed.

Use this setup when you want BigCommerce and Starshipit to stay in sync for fulfilment workflows.

## What you need before you start

- Admin access to your BigCommerce store
- Admin access to your Starshipit account
- A BigCommerce API account using a **V2/V3 API token**

## 1. Create an API account in BigCommerce

Use this step to generate the credentials Starshipit needs to connect.

1. In BigCommerce, [create a user API account for BigCommerce](https://support.bigcommerce.com/articles/Public/Store-API-Accounts).
2. Select **V2/V3 API token**.
3. Set the OAuth scopes listed below and leave unlisted scopes unchanged.

These permissions allow Starshipit to import orders and update tracking details correctly.

| 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 |

:::important
Copy and store your **API Path**, **Client ID**, and **Access Token** now. BigCommerce does not show these credentials again.
:::

After this step, you will have the API credentials needed for Starshipit.

## 2. Enter your BigCommerce API credentials in Starshipit

Use this step to create and save the integration in Starshipit.

1. In Starshipit, click **Settings** > **Integrations** > **Add a new integration** > **BigCommerce**.
2. Enter a store name that helps you identify this BigCommerce store.
3. Leave **Username** empty.
4. Enter **API Path**, **Client ID**, and **Access Token** from BigCommerce.
5. Click **Save**.

![BigCommerce integration form in Starshipit showing where to enter API Path, Client ID, and Access Token](/uploads/articles/integrations/ecommerce-platforms/how-to-integrate-with-bigcommerce/image_360001000796.png)

After you save, BigCommerce is connected and ready for import.

## 3. Choose which BigCommerce order statuses to import

Use these status codes to control which orders are imported into Starshipit.

:::warning
Your selected statuses directly affect which orders appear in Starshipit and can affect fulfilment reporting views.
:::

- Status 9 = Awaiting Shipment
- Status 11 = Awaiting Fulfillment
- Status 2 = Shipped [For Update Order]
- Status 10 = Completed [For Update Order]

[See the full list of BigCommerce order status codes](https://developer.bigcommerce.com/legacy/v2-products/v2-v3).

After choosing statuses, Starshipit imports only orders that match your selected status values.

## 4. Import orders from BigCommerce

Use this step when you want to run your first import or manually refresh orders.

1. Click the **Shipments** tab at the top of the page in Starshipit.
2. Click **Import**, then select **BigCommerce** and the number of days to import.
3. Click **Import** at the bottom right.
4. Review the number of imported orders.
5. Click **Close**.

After import completes, the Shipments page reloads with your newly imported orders.

## Advanced settings

### Authority to Leave (ATL)

BigCommerce Authority to Leave is supported.

For ATL to import correctly from BigCommerce:

- The billing form field name must be **Delivery Option**.
- The field value must contain either **authority to leave** or **signature required**.

### Product options

Starshipit imports product options when they use these display names:

- Size
- HS Code
- Color or Colour

### Pick up in store

Use this option when you want Starshipit to process BigCommerce pickup orders.

1. Open your BigCommerce integration settings in Starshipit.
2. Tick **Enable Pickup in Store**.
3. Click **Save**.

When enabled, shipments printed with a pickup in-store carrier are written back as **Awaiting Pickup**.

## Manage multiple storefronts

### How it works

When enabled, **Import Channel ID as a tag** adds each order's Storefront ID as a tag in Starshipit. This helps you manage multiple BigCommerce storefronts in one account.

With this setting, you can:

- **Filter orders** in the orders grid by specific storefront IDs.
- **Create rules** using storefront tags, for example: If Tag = [Storefront ID], assign to X account.

Starshipit also supports writeback for multi-storefront setups.

### How to enable it

Use this option when you run multiple BigCommerce storefronts and need storefront-specific filtering or rules.

1. Click **Settings** > **Integrations** > **BigCommerce**.
2. Scroll to the bottom of the page.
3. Tick **Import Channel ID as a Tag**.
4. Click **Save**.

When ticked, Starshipit imports each order with its storefront ID as a tag. When unticked, storefront ID tags are not added on import.