Create sales channel
create_sales_channelCreates a sales channel with a unique public key, currency, price access, and display mode, enabling storefronts to sell products under channel-specific pricing and access rules.
Instructions
Create a sales channel, at most 20 per workspace; a duplicate key is refused. The channel prices nothing until a price list is published to it (create_price_list / update_price_list with channels): one undated base list plus dated lists whose windows do not overlap. Channel keys are public - any storefront can send one - so priceAccess decides who sees its prices and may buy through it. currency picks what the channel sells in (the default currency when omitted): its carts, orders, shipping and discounts are in it, and a product with no price in it is not sold there.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"key": "<key>",
"name": "<name>"
},
"name": "create_sales_channel"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | What the storefront sends as channel: 1-40 lowercase letters and digits, words joined by - or _ (e.g. 'horeca'). Cannot change later; orders keep it. | |
| name | Yes | Display name, e.g. 'HoReCa' | |
| currency | No | The currency the channel sells in: the workspace's default currency (or null) or one of its additional currencies (update_cart_config additionalCurrencies) | |
| displayMode | No | How visitors and customers without a company read the channel's prices: net (VAT added on top) or gross (VAT inside). Default gross; a company buyer keeps their company's mode. | |
| priceAccess | No | Who sees the channel's prices and may buy through it: PUBLIC - anyone (default); MEMBERS - signed-in customers, and registration is open; COMPANY_MEMBERS - buyers of an approved company, the one to use for trade prices. Others get prices withheld and carts refused. |