BigCommerce Integration Setup Guide

This page provides a step-by-step guide to integrating BigCommerce as a sales channel within Helm. You’ll learn how to generate the necessary API credentials from your BigCommerce store, configure your channel settings in Helm, and establish a secure connection for order and inventory synchronisation.

Last updated 3 months ago

Prerequisites

  • Ensure you have administrative access to Helm.

  • Access to your BigCommerce store dashboard.

  • Ability to create and manage API accounts within BigCommerce.

Step 1: Generate API Credentials in BigCommerce

  1. Log in to your BigCommerce admin dashboard via your store’s login page.

  2. In the left-hand sidebar, scroll down and click Settings.

    image-1659689709549.jpg

  3. Within the Settings menu, scroll to the Advanced Settings section and click API Accounts.

    image-1659689731353.jpg

  4. Click Create API Account.

    image-1659690334239.jpg

  5. In the Name field, enter a label for this API connection.

    • Example: Helm Connection or Order Sync API

  6. Under OAuth Scopes, assign the following permissions:

    Customers: Read-Only 
Orders: Modify 
Products: Modify


    image-1659696719241.jpg

    Once the scopes are configured, click Save in the bottom-right corner.

  7. A .txt file will be downloaded automatically. This contains your credentials, including:

    • Client ID

    • Client Secret

    • Access Token

    • API Path (used to retrieve your Store Hash)

      image-1659696828731.jpg

Note:
To find your Store Hash, refer to the URL in the API Path field:

https://api.bigcommerce.com/stores/<storehash>/v3/

It is also highlighted down below:

image-1652423512464.png

About Order Statuses, you can choose any of them by default. But we don't recommend you to choose anything other than Incomplete and Partially Shipped orders because we don't do anything with Shipped, Refunded, or Cancelled orders.

image-1657546393370.jpg

Step 2: Install the BigCommerce Sales Channel in Helm

  1. In Helm, click Settings in the bottom-left corner of the dashboard.

  2. Navigate to Sales Channels.

  3. Locate BigCommerce in the list of available integrations and click Install.

Step 3: Configure the Integration Fields

Once the installation form opens, complete the following fields:

Active

Toggle ON to activate the sales channel.

Name

Provide a unique name for this integration.

  • Example: BigCommerce – UK Retail Store

Client ID

Paste the Client ID obtained from the downloaded credentials file.

Client Secret

Paste the Client Secret from the same file.

Access Token

Paste the Access Token provided in the API credentials file.

Store Hash

Extract and enter your Store Hash from the API Path URL.

Explore any additional configuration options to align the integration with your sales processes or data preferences.

Warehouse Selection

Click Settings in the top tab and choose the Helm warehouse from which goods will be despatched for this integration.

Explore the configuration settings to further tailor and enhance your integration according to your fulfilment strategy and vendor agreements.

Optional configuration tabs include:

  • Stock Control – Set up Auto Sync Stock.

  • Brand – Setup your Company Information for this sales channel below. By default your Company Information as set in General Settings will be used.

  • Commercial Invoice – Setup your Commercial Invoice Information for this sales channel below. By default your Commercial Invoice Information as set in General Settings will be used.

  • Despatch Emails – Do you want Helm to send out an order despatched email with carrier tracking information (if applicable)? If you do setup your Despatch Email for this sales channel below.

  • Feedback Emails – Do you want Helm to send out an order feedback email? If you do, setup your Despatch Email for this sales channel below.

Adjust these according to your business requirements.

Once all fields are complete, click Submit.

Completion

After submission:

  • A confirmation message will appear in the top-right corner of your screen.

  • Your BigCommerce sales channel will now be visible in your integrations list.

  • Orders, customers, and product data will begin syncing based on your preferences.

Additional Notes

  • You may return to Settings → Sales Channels → BigCommerce at any time to update credentials or modify sync preferences.

  • API credentials can be regenerated from BigCommerce if needed, but will require reconfiguration within Helm.

  • If managing multiple BigCommerce stores, you may install separate instances with distinct credentials and identifiers.