Skip to main content

createSalesChannel

Creates a new sales channel for the specified brand. 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
  • **Brand Validation**: The specified brand must exist and be accessible
  • **Uniqueness**: Sales channel names must be unique within a brand
  • **Template Validation**: Default templates must belong to the same brand (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**: Brand or default template doesn't exist
  • **CONFLICT**: Sales channel name already exists for the brand
  • **UNAUTHORIZED**: Missing required permissions or invalid brand access

Integration Notes​

When default_channel is set to true, the system will update the brand'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 brand context
createSalesChannel(
  input: CreateSalesChannelInput!
): SalesChannel!

Arguments​

createSalesChannel.input ● CreateSalesChannelInput! non-null input​

Parameters for CreateSalesChannel

Type​

SalesChannel object​

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.