Create a price list via REST API POST /v3/pricelists with a name and currency_code; price lists override base variant prices for assigned customer groups.
Add price records to the price list via POST /v3/pricelists/{priceListId}/records with variant_id, price, and sale_price fields.
Assign the price list to a customer group via PUT /v2/customer_groups/{customerGroupId} with the price_list_id field; customers in that group will see price list prices.
In a headless storefront, authenticate the customer via the Customer Login JWT flow to establish a customer session so price list prices are returned in the GraphQL Storefront API.
Verify price list resolution by querying product.variants.prices in the GraphQL Storefront API with a valid customer session and confirming the returned price matches the price list record.
Consult current BigCommerce B2B Edition docs if you need more advanced B2B features (company accounts, shared shopping lists); these require the B2B Edition add-on.
Known gotchas
Price list records must cover all currency variants if your store is multi-currency; uncovered currencies may fall back to base price or be unavailable depending on store configuration.
Customer group assignment is server-side; a headless storefront must establish an authenticated customer session via the Customer Login API for price list prices to be resolved in Storefront API responses.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp