Skip to main content

createSalesChannel

Creates a new sales channel for the specified company. Sales channels represent different sources through which orders can be placed, such as e-commerce platforms, retail stores, wholesale partners, or marketplaces.

Business Rules​

  • **Name Requirements**: Must be 1-50 characters and cannot be only spaces
  • **Uniqueness**: Sales channel names must be unique within the company
  • **Template Validation**: Default templates must belong to the same company (wholesale channels only)
  • **Routing Strategy**: Only valid strategies are accepted (SS, SD, BP)

Error Scenarios​

  • **BAD_REQUEST**: Invalid name length, empty name, or invalid routing strategy
  • **NOT_FOUND**: Default template doesn't exist
  • **CONFLICT**: Sales channel name already exists for the company
  • **UNAUTHORIZED**: Missing required permissions or invalid company access

Integration Notes​

When default_channel is set to true, the system will update the company's default sales channel. The approve_orders setting controls whether pending orders require manual approval or are automatically processed when issues are resolved.

Permissions Required​

  • create_sales_channel permission
  • Access to the specified company context
createSalesChannel(
  input: CreateSalesChannelInput!
): SalesChannel!

Arguments​

createSalesChannel.input ● CreateSalesChannelInput! non-null input common​

Parameters for CreateSalesChannel

Type​

SalesChannel object sales-channels​

Sales Channel​

Represents a sales channel within a brand. Sales channels define different sources through which orders can be placed and managed, including configuration for routing, fulfillment, and order processing behavior.