Skip to main content

updateSalesChannel

Update Sales Channel​

Updates an existing sales channel with new configuration values. Only provided fields will be updated; omitted fields will retain their current values.

Business Rules​

  • **Existence Validation**: The sales channel must exist and be accessible
  • **Name Requirements**: If provided, must be 1-50 characters and cannot be only spaces
  • **Uniqueness**: Updated names must remain unique within the brand
  • **Template Validation**: Default templates must belong to the same brand
  • **Routing Strategy**: Only valid strategies are accepted (SS, SD, BP)
  • **Integration Validation**: Integration must exist and belong to the same brand
  • **Update Requirement**: At least one field must be provided for update

Error Scenarios​

  • **BAD_REQUEST**: Invalid name length, empty name, invalid routing strategy, or no fields provided
  • **NOT_FOUND**: Sales channel, default template, or integration doesn't exist
  • **CONFLICT**: Updated name already exists for another sales channel in the brand
  • **UNAUTHORIZED**: Missing required permissions or invalid brand access

Integration Notes​

When updating default_channel 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​

  • update_sales_channel permission
  • Access to the sales channel's brand context
updateSalesChannel(
  input: UpdateSalesChannelInput!
): SalesChannel!

Arguments​

updateSalesChannel.input ● UpdateSalesChannelInput! non-null input​

Parameters for UpdateSalesChannel

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.