BigCommerce Connector Configuration

This Bloomreach Experience Manager feature requires a standard or premium license. Please contact Bloomreach for more information.


As explained in Configure brX GraphQL Service, the .env file contains the connection settings to integrate with BigCommerce.

Configuration Options

The following options are supported:

Property Name (* required field) Description Example Value(s) Default Value


The Base URL of the BigCommerce Management API. ''  


The Store Key, aka Store Hash, used for the BigCommerce Management API requests 



The Client ID received while creating the Store API Credentials 'bman1tnrjinwnm9f33eez19b4he179n'  


The Access Token received while creating the Store API Credentials 'h5qz4f87dnbo454qws4pawulst8wbm12'  

Authentication Scope

It is recommended to enable the following scopes while creating the Store API Credentials:

Scope GUI Name Description
Orders View orders
Products View products, brands, categories and other product information.
Carts View and modify carts
Checkouts View and modify checkouts
Customer View and modify customers and the related addresses
Wishlists View and modify wishlists

Recover Customer Password

BigCommerce does not support the recover customer password flow in the case of headless integrations. However, the GraphQL Service is able to provide this feature for the BigCommerce connector: this solution is compliant to the OWASP Forgot Password cheatsheet. In case you are interested in supporting the forgot password flow, please add the property described in the table below as part of your environment variables. Moreover, please also ensure to use an external notification service (e.g. email service), responsible for sending the method to reset the customer password. 

Property Name Description Example Value(s) Default Value


The URL of the trusted email service.

The email service implementation (e.g. REST service) must be able to process the request triggered by the brX GraphQL Service. The request body has the following structure:

  "customer": {
    "email": "...",
    "firstName": "...",
    "middleName": "...",
    "lastName": "...",
    "title": "...",
    "salutation": "...",
    "locale": "..."
  "attrs": {...},
  "token": "XXX"

Customer Addresses

BigCommerce does not seem to differentiate between Billing and Shipping addresses: for that reason all the addresses are marked both as billing and shipping. Moreover, BigCommerce doesn't seem to handle the concept of default addresses: the GraphQL Service then considers the first address of the list as the default. 


BigCommerce does not support "description" field for a wishlist entity; therefore, any description update trials are just ignored. The "description" fields will always be an empty string. BigCommerce does not support "quantity" in a wishlist entry, either; therefore, any quantity update trials are just ignored. The "quantity" fields will always be 1.

Did you find this page helpful?
How could this documentation serve you better?
On this page
    Did you find this page helpful?
    How could this documentation serve you better?

    We rely on cookies

    to optimize our communication and to enhance your customer experience. By clicking on the Accept and Close button, you agree to the collection of cookies. You can also adjust your preferences by clicking on Manage Preferences. For more information please see our Privacy policy.

    Manage cookies
    Accept & close

    Cookies preferences

    Accept & close