Skip to main content

Create a Rule Promotion

POST 
/v2/rule-promotions

Creates a new rule-based promotion, allowing flexible discount strategies based on cart or item conditions. Promotions can apply fixed or percentage-based discounts, apply automatically or via codes, and have eligibility rules based on product attributes, cart total, SKU conditions, custom attributes, and more.

This endpoint supports a variety of promotion types, such as:

  • Cart-wide discounts
  • Item-specific discounts
  • Shipping discounts
  • Combinations thereof
note

The minimum item discount amount is zero, both for amounts and percentages

Please refer to the OpenAPI examples section on this page for detailed request payloads illustrating different promotion structures, including cart discounts, item discounts, and rule-based conditions.

Request​

Responses​

Created