BigCommerce

Create and configure a new API account in BigCommerce to generate API credentials for Wherehouse.

Published on:

Do not index
Do not index
To connect Wherehouse with BigCommerce via API, you’ll need to generate API keys directly from your BigCommerce control panel by creating an API account.
Before you start, ensure you have the correct user permissions. Only the store owner or users with "Advanced Settings" permissions can create and manage API accounts.

Steps on Wherehouse 👨‍💻

notion image
1️⃣  On the Wherehouse dashboard, within the subscription you’d like to authorize, select Platforms from the sidebar
 
notion image
2️⃣  Locate the BigCommerce connector(s)
👉
You may have multiple connectors depending on your setup. Repeat the steps for each one that needs authorization.
3️⃣  Click Authorize
 
notion image
Here you will enter the following credentials from BigCommerce:
  • Client ID
  • Client Secret
  • Access Token
 
Steps on how to obtain these below ⬇️
 
 

Steps on BigCommerce 👨‍💻

 
1️⃣ Log in and navigate to API Accounts:
notion image
  • Log in to your BigCommerce dashboard
  • Go to Settings > Store-level API accounts
  • Click + Create API Account
 
2️⃣ Select the Token type:
notion image
  • A dropdown menu will appear.
  • Select Create V2/V3 API token.
 
3️⃣ Name your API account:
notion image
Enter a clear, descriptive name (this is for your reference)
👉 We recommend: Wherehouse
 
4️⃣ Note your API path:
notion image
  • Copy and save your API path
    • ☝️ You’ll need to enter it on the Wherehouse modal
  • If you use B2B Edition in your BigCommerce store, use the B2B Edition API path
 
5️⃣ Set the OAuth Scopes (Permissions):
notion image
 
For each API resource, set the permission level as follows:
  • App Extensions: None
  • Carts: None
  • Channel Settings: modify
  • Channel Listings modify
  • Checkouts: None
  • Checkout Content: None
  • Content: None
  • Customers: modify
  • Customer Login: modify
  • Fulfillment Methods: modify
  • Information & Settings: None
  • Marketing: None
  • Metafield Ownership: manage
  • Metafields Access: full
  • Orders: modify
  • Order Fulfillment: modify
  • Order Transactions: modify
  • Payments - Get accepted methods: None
  • Products: modify
  • Sites & Routes: None
  • Store Inventory: modify
  • Store Locations: modify
  • Stored Payment Instruments: None
  • Store Translations: None
  • Themes: None
 
5️⃣ Save and Copy Your Credentials:
  • Once you've configured the name and scopes, click Save.
  • A pop-up window will appear displaying your API credentials:
    • Client ID
    • Client Secret
    • Access Token
    • 🚨
      This is the only time these credentials will be shown.
  • Be sure to immediately copy and store them securely. If lost, you’ll need to create a new API account.
  • BigCommerce will also prompt you to download a text file containing the credentials — save it safely.
  • You’ll now enter these credentials in Wherehouse (step 4️⃣ in the below)
 

Back on Wherehouse 👨‍💻

notion image
4️⃣ Enter the BigCommerce API credentials you’ve copied into the Wherehouse modal:
  • API Path
  • Client ID
  • Client Secret
  • Access Token
 
notion image
5️⃣  Hit save and if all went well you should see “Successfully authorized connector”.