Migrate BigCommerce B2B Edition API authentication from legacy authToken to V3 API account tokens

domain: developer.bigcommerce.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Understand the change: as of September 30, 2025 the B2B Edition-specific authToken is deprecated for server-to-server calls; December 31, 2025 is the cutoff for creating new legacy authTokens in the B2B Edition control panel — existing tokens are not hard-sunset on that date, but migration is strongly advised.
  2. In the BigCommerce Control Panel navigate to Settings > Store-level API accounts and click Create API Account.
  3. Select V3 Token type and set the B2B Edition scope to 'modify'; save the ACCESS TOKEN and STORE HASH values securely.
  4. Replace the Authorization: authToken header in your server-to-server requests with two headers: X-Auth-Token (the access token) and X-Store-Hash (the store hash).
  5. Test each B2B REST Management API endpoint with the new headers; note that storefront requests and storefront authTokens are unaffected by this change.
  6. Delete unused legacy API accounts from the B2B Edition Settings panel after confirming all integrations work with the new token structure.

Known gotchas

Related routes

Migrate a NetSuite integration from Token-Based Authentication (TBA) to OAuth 2.0 client credentials (M2M)
netsuite · 5 steps · unrated
Migrate a Tripleseat integration from OAuth 1.0 to OAuth 2.0
api.tripleseat.com · 5 steps · unrated
Build a BigCommerce custom app using storefront API tokens to implement a headless B2B quote request workflow
BigCommerce B2B headless · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans