Manage multi-storefront channels and channel-specific listings in BigCommerce

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. Create a new storefront channel by sending POST to `/v2/channels` (or the appropriate Channels API endpoint) with `type: storefront` and the required `platform` and `name` fields; record the returned `channel_id`.
  2. Assign products to the new channel using the Catalog API's channel assignments endpoint: POST `/v3/catalog/products/channel-assignments` with an array of `{product_id, channel_id}` objects.
  3. Create channel-specific listings via POST `/v3/catalog/channels/{channel_id}/listings` to override product name, description, or images for that channel.
  4. Configure the channel's site and routing by calling the Sites API to associate a domain and set URL rules for the storefront.
  5. Use `GET /v3/catalog/channels/{channel_id}/listings` to audit which products have channel-specific overrides and identify products assigned but not listed.
  6. Set required OAuth scopes: Channel Listings (modify), Channel Settings (modify), Sites & Routes (modify), and Catalog (read/write).

Known gotchas

Related routes

Query BigCommerce product catalog and cart data via the GraphQL Storefront API including complex variant selection and pricing
developer.bigcommerce.com · 5 steps · unrated
manage products and variants with the bigcommerce catalog api including rate limits
bigcommerce.com · 6 steps · unrated
Distinguish Merchant Center feed-driven Shopping listings from on-page Product structured data-driven organic rich results, and configure both without signal conflicts
developers.google.com · 5 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