---
title: "configureChannelCatalog - Configure Catalog capabilities for a channel"
method: POST
path: "/v1/catalog-configuration/channels/{channel_id}"
tags: ["Catalog Configuration"]
---

# configureChannelCatalog - Configure Catalog capabilities for a channel

`POST /v1/catalog-configuration/channels/{channel_id}`

## Request

- Base URL: `https://miraklconnect.com/api/channel-platform`
- URL: `https://miraklconnect.com/api/channel-platform/v1/catalog-configuration/channels/{channel_id}`
- Auth: HTTP bearer

<div class="api-description-extension">
<div class="extension-title">Call Frequency</div>

<div class="recommended-call-frequency">Recommended usage: only once, at channel setup</div>
<div class="max-call-frequency">Maximum usage: 1 per minute</div>
</div>

## Request body

- ChannelCatalogCapabilities
  - `behaviors` Behaviors
    - `emit_group_of_products` string: List of standard attributes that can be used to group product updates Enum: `"BRAND"`, `"VARIANT_GROUP_CODE"`
  - `discount_prices` DataConfiguration
    - `lifecycle` string, required: Granularity level at which the data is configured Enum: `"PER_STORE"`, `"PER_SUB_CHANNEL"`
    - `per_store_default` PerStoreDefault: Only applicable when lifecycle is PER_SUB_CHANNEL. Configures whether a per-store default value is used as a fallback.
      - `support` string: Whether the per-store default is required, optional, or unsupported Enum: `"REQUIRED"`, `"OPTIONAL"`, `"UNSUPPORTED"`
  - `offer_configuration` OfferConfiguration
    - `custom_attributes` Attribute[]: Attributes the sellers must configure for offer-related features
      - `configuration_modes` ConfigurationMode[], required: List of accepted configuration modes for providing the value
      - `descriptions` Localized[]: Additional attribute descriptions
        - `locale` string, required: The language format can be ISO-639 or ISO-639_ISO-3166
        - `value` string, required: The localized value in this locale
      - `id` string, required: Id of the attribute
      - `labels` Localized[], required: Labels of the attribute
        - `locale` string, required: The language format can be ISO-639 or ISO-639_ISO-3166
        - `value` string, required: The localized value in this locale
      - `requirement_level` string, required: Requirement level of the attribute Enum: `"OPTIONAL"`, `"RECOMMENDED"`, `"REQUIRED"`
      - `type` string, required: Enum: `"Boolean"`, `"Numeric"`, `"Text"`, `"List"`
    - `pricing_configuration` PricingConfiguration: Configuration for pricing capabilities.
      - `discount_price_period` DiscountPricePeriod: Configuration for discount price period.
        - `end_date` PricingConfigurationField, required: Pricing configuration field
          - `requirement_level` string, required: Requirement level of the attribute Enum: `"OPTIONAL"`, `"REQUIRED"`
        - `start_date` PricingConfigurationField, required: Pricing configuration field
          - `requirement_level` string, required: Requirement level of the attribute Enum: `"OPTIONAL"`, `"REQUIRED"`
        - `support` string, required: Support for the discount price period Enum: `"SUPPORTED"`, `"UNSUPPORTED"`
  - `standard_prices` DataConfiguration
    - `lifecycle` string, required: Granularity level at which the data is configured Enum: `"PER_STORE"`, `"PER_SUB_CHANNEL"`
    - `per_store_default` PerStoreDefault: Only applicable when lifecycle is PER_SUB_CHANNEL. Configures whether a per-store default value is used as a fallback.
      - `support` string: Whether the per-store default is required, optional, or unsupported Enum: `"REQUIRED"`, `"OPTIONAL"`, `"UNSUPPORTED"`
  - `stock_quantities` StockDataConfiguration: Stock configuration. Unlike prices, stock does not support a per-store default value as a fallback when configured per sub-channel.
    - `lifecycle` string, required: Granularity level at which the data is configured Enum: `"PER_STORE"`, `"PER_SUB_CHANNEL"`
  - `use_case_configurations` UseCaseConfigurations: Configuration for offer related features by use case. This API provides the configuration of required offer fields by use cases
    - `offer_creation` UseCaseConfiguration, required: Configuration for a specific use case. This API provides the configuration of required offer fields by use cases
      - `optional` UseCaseConfigurationAttributes
        - `custom_attributes` string[]
        - `standard_attributes` string[]
      - `required` UseCaseConfigurationAttributes, required
        - `custom_attributes` string[]
        - `standard_attributes` string[]
      - `support` string, required: Support for the use case Enum: `"SUPPORTED"`, `"UNSUPPORTED"`
    - `offer_update` UseCaseConfiguration, required: Configuration for a specific use case. This API provides the configuration of required offer fields by use cases
      - `optional` UseCaseConfigurationAttributes
        - `custom_attributes` string[]
        - `standard_attributes` string[]
      - `required` UseCaseConfigurationAttributes, required
        - `custom_attributes` string[]
        - `standard_attributes` string[]
      - `support` string, required: Support for the use case Enum: `"SUPPORTED"`, `"UNSUPPORTED"`

## Response `202`

Accepted

## Other responses

- `400`: Bad Request - the request body does not match the API contract. The body is an `application/problem+json` document with a `code`, a `message` and an `errors` array. The `errors` array lists the violations found (up to a maximum, the `message` then says the list is truncated). Each error gives the JSON path of the offending value in `field` (`$` for the whole document) and what is wrong in `message`.

## Changes

- **2026-11-07** `5fe2e95ce715`: 1 info
  - added the non-success response with the status `400`
- **2026-08-29** `36b60082f6f9`: 1 info
  - added the new optional request property `behaviors`

[Operation history](https://skmtc.dev/mirakl/apis/mirakl-connect-channel-platform-apis/changes/v1/catalog-configuration/channels/:channel_id/post.md)

---

[API](https://skmtc.dev/mirakl/apis/mirakl-connect-channel-platform-apis.md) - [All operations](https://skmtc.dev/mirakl/apis/mirakl-connect-channel-platform-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/mirakl/apis/mirakl-connect-channel-platform-apis/revisions/483f81c7dd91?raw)