This guide explains how to connect a BigCommerce store to API2Cart by creating a store-level API account, selecting the minimum required permissions, and adding the generated credentials to API2Cart.

Step 1: Open Store-level API accounts

Sign in to the BigCommerce control panel. Go to Settings → Store-level API accounts.

Open Store-level API accounts in the BigCommerce control panel

Step 2: Create a V2/V3 API token

Click Create API Account, select V2/V3 API token, and enter a recognizable name, such as API2Cart Integration. BigCommerce generates the API path automatically.

Create a BigCommerce V2/V3 API token and configure OAuth scopes

Step 3: Configure API permissions

Set each permission separately. For the complete API2Cart feature set, use the following access levels:

  • Products — Modify
  • Orders — Modify
  • Order Transactions — Modify
  • Customers — Modify
  • Marketing — Modify
  • Content — Modify
  • Carts — Modify
  • Checkouts — Modify
  • Store Inventory — Modify
  • Information & Settings — Read-Only
  • Channel Settings — Read-Only
  • Channel Listings — Modify
  • Sites & Routes — Read-Only
  • Store Locations — Read-Only

Leave all other permissions on None. API2Cart does not require Themes, Checkout Content, Customers Login, Fulfillment Methods, or Order Fulfillment for the methods covered by this integration. BigCommerce webhooks use the default webhook scope and have no separate permission selector.

If you use only a subset of API2Cart methods, grant only the permissions listed for those methods in the table below. Modify includes read access.

Step 4: Save the credentials

Click Save. BigCommerce displays the Client ID, Client Secret, and Access Token. Save the downloaded credentials file securely: the access token is displayed only once. API2Cart requires the Client ID, Access Token, and the store hash from the API Path. The store hash is the value between /stores/ and /v3/.

Copy the BigCommerce Client ID and Access Token

Step 5: Connect BigCommerce to API2Cart

  1. Sign in to your API2Cart account.
  2. Click Add New Store and select BigCommerce.
  3. Enter the store URL, store hash/API path, Client ID, and Access Token.
  4. Click Connect. API2Cart validates the credentials and permissions.

Optional: Use the BigCommerce app OAuth flow

For an app-level integration, configure and install a BigCommerce app, then exchange its authorization code for an access token. API2Cart uses the resulting Client ID, Access Token, and context value, for example stores/{store_hash}.

If you don't already have a draft app, create one first: sign in to the BigCommerce Developer Portal, click Create an App, and enter a name for it. The new app is added as a draft, which you can then edit.

In the BigCommerce control panel, open Apps → Develop and choose Edit for your draft app.

Open BigCommerce Apps Develop and edit the draft app

In the Developer Portal, note the client credentials and enter your own Auth and Load callback URLs.

Configure the BigCommerce app callback and auth URLs

Open Scopes, select Set manually, and choose the required access levels.

Select OAuth scopes for the BigCommerce app

Save the configuration and start installation. Review the requested permissions, then click Install.

Install the BigCommerce app and complete authorization

When a store owner installs the app, BigCommerce sends a GET request to your public HTTPS Auth endpoint with code, context, scope, and account_uuid. Your server must exchange the code for an access_token by sending a POST request to https://login.bigcommerce.com/oauth2/token. Include client_id, client_secret, code, context, scope, grant_type set to authorization_code, and redirect_uri in the JSON body. The redirect_uri must exactly match your registered Auth URL. See the BigCommerce OAuth authentication guide.

For app-level OAuth scopes, the minimum equivalents of Step 3 are: store_v2_products, store_v2_orders, store_v2_transactions, store_v2_customers, store_v2_marketing, store_v2_content, store_cart, store_checkout, store_inventory, store_v2_information_read_only, store_channel_settings_read_only, store_channel_listings, store_sites_read_only, and store_locations_read_only. Selecting the corresponding modify scopes also works, but grants broader access.

For additional details about API accounts and scope names, see the official BigCommerce API Accounts documentation.


Required BigCommerce permissions by API2Cart method

* Optional: the method still works, but related data is omitted and API2Cart may return a warning.
** Conditional: required only when the corresponding field or parameter is requested.

API2Cart method(s)Minimum BigCommerce permission
cart.infoInformation & Settings — Read-Only; Channel Settings — Read-Only *; Channel Listings — Read-Only *; Sites & Routes — Read-Only *
cart.coupon.countMarketing — Read-Only
cart.coupon.listMarketing — Read-Only
cart.coupon.addMarketing — Modify
cart.coupon.condition.addMarketing — Modify
cart.coupon.deleteMarketing — Modify
cart.giftcard.listMarketing — Read-Only
cart.giftcard.addMarketing — Modify
cart.giftcard.deleteMarketing — Modify
cart.meta_data.listProducts — Read-Only; Orders — Read-Only
cart.meta_data.setProducts — Modify; Orders — Modify
cart.meta_data.unsetProducts — Modify; Orders — Modify
cart.script.listContent — Read-Only
cart.script.addContent — Modify
cart.script.deleteContent — Modify
cart.shipping_zones.listInformation & Settings — Read-Only
basket.infoCarts — Read-Only
category.infoProducts — Read-Only
category.countProducts — Read-Only
category.listProducts — Read-Only
category.findProducts — Read-Only
category.addProducts — Modify
category.add.batchProducts — Modify
category.updateProducts — Modify
category.deleteProducts — Modify
category.assignProducts — Modify
category.unassignProducts — Modify
category.image.addProducts — Modify
category.image.deleteProducts — Modify
customer.infoCustomers — Read-Only; Orders — Read-Only **
customer.countCustomers — Read-Only
customer.listCustomers — Read-Only; Orders — Read-Only **
customer.findCustomers — Read-Only
customer.addCustomers — Modify
customer.updateCustomers — Modify
customer.address.addCustomers — Modify
customer.group.listCustomers — Read-Only
customer.group.addCustomers — Modify
customer.wishlist.listCustomers — Read-Only
subscriber.listCustomers — Read-Only
order.infoOrders — Read-Only; Customers — Read-Only *; Order Transactions — Read-Only *
order.countOrders — Read-Only
order.listOrders — Read-Only; Customers — Read-Only *; Order Transactions — Read-Only *
order.findOrders — Read-Only; Customers — Read-Only *; Order Transactions — Read-Only *
order.addOrders — Modify; Products — Read-Only
order.updateOrders — Modify
order.refund.addOrders — Modify or Order Transactions — Modify
order.shipment.listOrders — Read-Only
order.shipment.addOrders — Modify
order.shipment.add.batchOrders — Modify
order.shipment.updateOrders — Modify
order.shipment.deleteOrders — Modify
order.shipment.tracking.addOrders — Modify
order.status.listOrders — Read-Only
order.transaction.listOrder Transactions — Read-Only (hard-required)
order.calculateCarts — Modify; Checkouts — Modify; Products — Read-Only; Information & Settings — Read-Only; Channel Settings — Read-Only *; Channel Listings — Read-Only *; Marketing — Read-Only **
product.infoProducts — Read-Only; Store Inventory — Read-Only *
product.countProducts — Read-Only
product.listProducts — Read-Only; Store Inventory — Read-Only *
product.findProducts — Read-Only
product.fieldsProducts — Read-Only
product.addProducts — Modify; Store Inventory — Modify **
product.add.batchProducts — Modify; Store Inventory — Modify **
product.updateProducts — Modify; Store Inventory — Modify **
product.update.batchProducts — Modify; Store Inventory — Modify **
product.deleteProducts — Modify
product.delete.batchProducts — Modify
product.brand.listProducts — Read-Only
product.manufacturer.addProducts — Modify
product.child_item.infoProducts — Read-Only; Store Inventory — Read-Only *
product.child_item.listProducts — Read-Only; Store Inventory — Read-Only *
product.image.addProducts — Modify
product.image.deleteProducts — Modify
product.image.updateProducts — Modify
product.option.addProducts — Modify
product.option.value.addProducts — Modify
product.option.value.updateProducts — Modify
product.price.addProducts — Modify
product.price.deleteProducts — Modify
product.variant.addProducts — Modify; Store Inventory — Modify **
product.variant.add.batchProducts — Modify; Store Inventory — Modify **
product.variant.updateProducts — Modify; Store Inventory — Modify **
product.variant.update.batchProducts — Modify; Store Inventory — Modify **
product.variant.deleteProducts — Modify
product.variant.delete.batchProducts — Modify
product.variant.image.addProducts — Modify
product.variant.price.addProducts — Modify
product.variant.price.deleteProducts — Modify
product.review.listProducts — Read-Only
product.store.assignProducts — Modify; Channel Settings — Read-Only; Channel Listings — Modify
tax.class.infoInformation & Settings — Read-Only
tax.class.listInformation & Settings — Read-Only
webhook.listWebhooks (default — no toggle)
webhook.countWebhooks (default — no toggle)
webhook.createWebhooks (default — no toggle)
webhook.updateWebhooks (default — no toggle)
webhook.deleteWebhooks (default — no toggle)
webhook.eventsWebhooks (default — no toggle)

Next step

Create an account and connect your first store via API2Cart.

Open app