Create Channel
Creates a new channel (storefront). The code must be unique. Top-level translatable scalars (name, description, the SEO fields, maintenanceModeText) are broadcast to every locale you assign, so a brand-new channel comes back with a translations entry per assigned locale.
Operation
| Operation | Type | Purpose |
|---|---|---|
createAdminSettingsChannel(input:) | Mutation | Create a channel |
Required input
| Field | Meaning |
|---|---|
code | Unique channel code. |
name | Channel display name (broadcast to every assigned locale). |
locales | Non-empty array of locale ids assigned to this channel. |
currencies | Non-empty array of currency ids assigned to this channel. |
inventorySources | Non-empty array of inventory-source ids. |
defaultLocaleId | Default locale — must be one of locales. |
baseCurrencyId | Base currency — must be one of currencies. |
rootCategoryId | Root category for the channel's catalog tree. |
Optional: hostname, description, timezone, theme, allowedIps, and the SEO triplet seoTitle / seoDescription / seoKeywords (which is rolled into homeSeo).
Notes
- The create mutation payload returns the channel's scalar fields, the SEO triplet (
seoMetaTitle/seoMetaDescription/seoMetaKeywords+ thehomeSeoobject). The nested connections (locales/currencies/inventorySources/translations) are not resolved in a mutation payload — re-queryadminSettingsChannel(id:)with the returned_idto read them.
Logo / favicon upload deferred
The logo and favicon fields accept an already-uploaded path string only. Direct binary image upload is not yet supported over GraphQL.

