Create a Coupon

📘

Expiration Overrides

By default, a coupon's expiration is determined by its valid_until attribute. However, if needed, you can override this expiration. Overrides can be applied both at the time of assignment and activation. These expiration rules do not apply to the Coupon entity itself but rather to the User Coupon entity, which is a duplicate of the original coupon but treated as a unique instance for each customer.

Expiration Override on Assignment
A coupon is assigned when it is directly given to a member via an API call, through the Content Cockpit, as a reward from Contests or Promo Events, or as part of a predefined Scenario.

Expiration Override on Activation
A coupon is activated when a member activates it manually via a mobile app, e-commerce website, or client portal. Activation can also occur automatically if Coupon Preactivation is enabled globally or if the coupon is flagged as Always Activated.

Expiration Types
There are three types of expiration overrides: absolute, relative, and period based.

• Absolute: Defines a specific timestamp when the User Coupon should expire.
• Relative: Sets an expiration period in units (seconds, hours, days...) starting from when the coupon is assigned or activated.
• Period: Expires the User Coupon at the end of a predefined period, such as an hour, day, week, month, quarter, or year.