Free gift promotions
The free gift promotion object and the allowed CRUD operations on the related resource endpoint
When triggered, free gift promotions are responsible for adding a discount to the orders involved. The discount amount is computed by setting to zero the price of the SKUs matching the associated list. Please note that the discount is applied only when an SKU matching the associated list is added to the order. It is possible to limit the free gifts by specifying a
max_quantity(default to 1), which also honors the quantities and positions of the list items.
Within the time window given by their activation and expiration dates, free gift promotions that have not reached their total usage limit are considered active. If no promotion rule is associated with an active free gift promotion, the free gift is applied to all the orders in the specified currency (or to all the orders of the market in scope, if the promotion is restricted to a specific market). Otherwise, if one or more promotion rules are defined, the promotion is triggered only when it matches all of them.