Add Channel-Based Market Conditions and New Error Codes

5/23/2026, 12:00:15 AM

The API now introduces a ChannelsCondition object that lets you evaluate whether a visitor’s channel matches a market’s criteria, and an input object MarketConditionsChannelsInput for passing channel IDs when creating or updating such conditions. The Channel type gains three new fields: activeRegions, markets (a paginated list of Market objects), and marketsCount, allowing clients to inspect a channel’s active geographic regions and the markets it belongs to. Correspondingly, the Market type receives channels, channelsCount, and is linked back to its associated channels. The enums MarketConditionType and MarketType now support a new CHANNEL value, enabling channel-specific condition types and market types. MarketConditions now includes a channelsCondition field, exposing the new channel-based condition structure. Additional error codes—INVALID_CHANNEL_IDS, CHANNEL_MARKET_MUST_HAVE_SINGLE_CHANNEL_DRIVER, CHANNEL_NOT_VALID_FOR_CHANNEL_MARKET, CHANNEL_DRIVER_MUST_HAVE_CHANNEL_SPECIFICATION, and REGION_NOT_SUPPORTED_FOR_CHANNEL—are added to MarketUserErrorCode to reflect validation rules when managing channel markets. Together, these changes empower developers to create, query, and validate markets that are explicitly tied to specific channels and regions while handling new error scenarios in API calls.

Type Changes

➕ Added Types (2)

🏗️ChannelsCondition➕ AddedOBJECT

A condition checking the channel that the visitor is shopping from.

Fields: applicationLevel, channels, channelsCount
📥MarketConditionsChannelsInput➕ AddedINPUT_OBJECT

The input fields required to create or update a channel market condition.

🔄 Modified Types (6)

🏗️Channel🔄 Modified
Field added: activeRegions

The regions where the channel is currently active. Includes spec-declared regions plus regions with active product feeds.

Field added: markets

The markets associated with this channel.

Field added: marketsCount

The number of markets associated with this channel.

🏗️Market🔄 Modified
Field added: channels

The channels associated with this market.

Field added: channelsCount

The number of channels associated with this market.

🏗️MarketConditionType🔄 Modified
Enum value added: CHANNEL
🏗️MarketConditions🔄 Modified
Field added: channelsCondition

The channel conditions that determine whether a visitor is in the market.

🏗️MarketType🔄 Modified
Enum value added: CHANNEL
🏗️MarketUserErrorCode🔄 Modified
Enum value added: INVALID_CHANNEL_IDS
Enum value added: CHANNEL_MARKET_MUST_HAVE_SINGLE_CHANNEL_DRIVER
Enum value added: CHANNEL_NOT_VALID_FOR_CHANNEL_MARKET
Enum value added: CHANNEL_DRIVER_MUST_HAVE_CHANNEL_SPECIFICATION
Enum value added: REGION_NOT_SUPPORTED_FOR_CHANNEL