Connecting a BigCommerce store

Vendably connects to BigCommerce using the BigCommerce REST API, authenticated with credentials from a BigCommerce API account. Once connected, Vendably runs a full import of your product catalogue.

For an overview of how product sources work in Vendably, see Connect a product source to DataHub.

What you need before connecting

• Your store hash: the identifier for your BigCommerce store, visible in your store's URL. When you are logged in to BigCommerce admin, the URL contains the pattern store-{hash}.mybigcommerce.com. The hash is the alphanumeric string that appears in place of {hash}.
• A Client ID and Client Secret from a BigCommerce API account with read access to Products and Orders.

Create a BigCommerce API account

1. Log in to your BigCommerce admin panel.
2. Go to Advanced Settings > API Accounts.
3. Click Create API Account and choose Create V2/V3 API Token.
4. Give the account a name (for example, Vendably).
5. Under OAuth Scopes, set the following permissions:
   - Products: Read-only
   - Orders: Read-only
   All other scopes can remain at None.
6. Click Save. BigCommerce displays the Client ID, Client Secret, and Access Token. Copy the Client ID and Client Secret.

The credentials are shown only once. If you close the page before copying them, you will need to delete the API account and create a new one.

Connect in Vendably

1. In the main navigation, go to DataHub then Sources.
2. Click Add source and select BigCommerce as the source type.
3. Enter your store hash, Client ID, and Client Secret.
4. Click Connect. Vendably verifies the credentials and confirms the connection.

What happens after connecting

Vendably runs a full import of your product catalogue automatically. Depending on catalogue size, this may take a few minutes to several hours. You can monitor progress from the source settings page.

Once your first import completes, check your feed health score to assess the completeness and quality of the imported data.

Troubleshooting

Authentication error: confirm that the Client ID and Client Secret match the API account you created, and that the account has not been deleted or deactivated in BigCommerce. Re-generating credentials requires creating a new API account.

Products missing after import: confirm that the products are active and visible in your BigCommerce catalogue. Vendably imports active products by default. Products set to Hidden will not be imported.

Store hash not accepted: locate the hash in the BigCommerce admin URL. It appears after store- and before .mybigcommerce.com. Copy the hash portion only, without the store- prefix or the domain suffix.