Admin Marketing: Promotions

Create a catalog rule

Create a catalog rule

post/marketing/catalog-rules

Request

Request body

namestring required
descriptionstring
starts_fromstring
ends_tillstring
statusinteger
sort_orderinteger
condition_typeinteger
conditionsobject[]
end_other_rulesinteger
action_typestring required
discount_amountnumber required
channelsinteger[] required

Assigned channel ids (request stays id-based; the response returns objects).

customer_groupsinteger[] required

Assigned customer-group ids (request stays id-based; the response returns objects).

Example request

{
  "name": "Summer 10% off",
  "description": "Sitewide 10% off summer collection",
  "starts_from": "2026-06-01",
  "ends_till": "2026-08-31",
  "status": 1,
  "condition_type": 1,
  "conditions": [],
  "action_type": "by_percent",
  "discount_amount": 10,
  "channels": [
    1
  ],
  "customer_groups": [
    1,
    2
  ]
}

Response

Catalog rule created.

Changes

No recorded changes to this operation across all 8 revisions of this API.