Flex promotions

The flex promotion object and the allowed CRUD operations on the related resource endpoint

Flex promotions enable you to cover the most comprehensive range of use cases you may need in your promotion strategy.

When triggered, flex promotions are responsible for adding a discount to the orders involved based on the conditions and actions provided in the associated rules.

Flex promotions are still in closed beta and available only to a shortlist of enterprise customers as beta testers. More detailed documentation about flex promotions and the related rules engine is coming soon in conjunction with the official public release.

For performace reasons, rules and rule_outcomes objects are returned when retrieving a single flex promotion only.

Application scope

Except for the case where you need them to be associated with a coupon, when using flex promotions you're not required to define any promotion rules, set a currency code, or associate a specific market. Just use the rules JSON object to define how and when the flex promotion should be applied.

Discount calculation and distribution

The total discount due to flex promotions is calculated and distributed on the matching line items, based on the conditions and actions provided in the associated rules.