Articles in this section

Set up a connection to BigCommerce (GraphQL)

Naga Sri Hari Gonaboyina
Updated

BigCommerce is a cloud-based, Saas eCommerce platform designed to help businesses build, run, and scale online stores. It supports both B2C (retail) and B2B (wholesale) selling, making it a flexible solution for a variety of merchants.

Important

BigCommerce has upgraded its token authentication mechanism. Users will no longer be able to create storefront tokens after June 30, 2026, and creating a private token is mandatory going forward. Hence, we recommend using Custom authentication while configuring the BigCommerce connection. If you are using Token authentication, we recommend reauthorizing your connection using Custom authentication at the earliest opportunity. For detailed information on how to reauthorize, see Reauthorize your BigCommerce (GraphQL) connection.

Set up a connection

After you start the connection, configure it in the Create connection panel and complete all of the required * authentication settings:

Setting

Instructions

Name your connection * 

Enter a clear and distinguishable name.

Throughout integrator.io imports and exports, you will have the option to choose this new connection. A unique identifier will prove helpful later when selecting it from a list of the connections in your account.

Subdomain * 

Enter your BigCommerce store subdomain. 

dataLoad.svg​​ How to retrieve the subdomain 

Auth type *

Select your BigCommerce account authentication type (Custom or Token).

Store hash * 

Enter your BigCommerce store hash.

dataLoad.svg​​ How to retrieve the store hash 

Channel ID  

Enter your storefront channel ID (default 1). For more information, see Channel IDs.

Access token * 

Enter your BigCommerce access token.

Multiple layers of protection, including AES 256 encryption, are in place to keep your token safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text.

dataLoad.svg​​ How to retrieve the access token 

Scopes * (Only for the Custom authentication)

Select the required scopes (Private tokens).

Tip

This connector documentation describes only the settings shown for the Simple view. For the corresponding HTTP settings, see the Custom and Token auth universal connector documentation, respectively.

How to retrieve the subdomain

  1. Sign in to your BigCommerce account.

  2. Click View storefront. Your store page will open.

  3. Copy the Subdomain. For example, if your store account URL is https://celigo.mybigcommerce.com/?ctk=e237, then celigo is the subdomain.

How to retrieve the store hash

  1. Sign in to your BigCommerce account.

  2. Copy the Store hash. For example, if your account URL is https://store-ci4bzn8adz.mybigcommerce.com/manage, then ci4bzn8adz is the store hash.

How to retrieve the access token

  1. Sign in to your BigCommerce account.

  2. Navigate to Settings > API > Store level API accounts.

  3. Click + Create API account.

  4. From Token type, select V2/V3 API token.

  5. Enter a Name.

    Note

    You can also retrieve your store hash from the API path. For example, if your API path is https://api.bigcommerce.com/stores/ci4bzn8adz/v3/, then ci4bzn8adz is the store hash.

  6. Select the OAuth scopes.

    Note

    The Storefront API tokens and Storefront API customer impersonation tokens scopes must be set to Manage.

  7. Click Save. The BigCommerce API credentials window opens.

  8. Copy the Access token.

Additional reference