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`.
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.
Create channel-specific listings via POST `/v3/catalog/channels/{channel_id}/listings` to override product name, description, or images for that channel.
Configure the channel's site and routing by calling the Sites API to associate a domain and set URL rules for the storefront.
Use `GET /v3/catalog/channels/{channel_id}/listings` to audit which products have channel-specific overrides and identify products assigned but not listed.
Set required OAuth scopes: Channel Listings (modify), Channel Settings (modify), Sites & Routes (modify), and Catalog (read/write).
Known gotchas
A product must be assigned to a channel before a channel listing can be created for it; attempting to create a listing for an unassigned product returns a 404 or validation error.
Channel-specific listing overrides (name, description, images) are independent of the base catalog record; deleting the base product does not automatically clean up orphaned listing records.
Multi-storefront is only available on BigCommerce Enterprise plans; channel creation on lower-tier stores will succeed but the storefront will not be independently accessible.
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