coupon.activated

When this fires

A creator switched a coupon on through the activate endpoint. Flipping the switch in the dashboard or through the bot does not currently emit this event; those surfaces write through the service layer directly.

This is the availability flip, kept out of coupon.updated on purpose: an automation that cares whether a discount is live wants one event to subscribe to, not a diff of the active key on every save.

Switched on is not the same as redeemable. active: true is one of four conditions. A coupon still will not apply if it is outside its starts_at / expires_at window, if every use is already spoken for, or if the buyer has hit their own per-subscriber cap. Check the window and the caps in the payload before announcing a live sale.

Caveats

• This is not scheduled. It fires when a person flips the switch. A coupon whose starts_at simply arrived does not emit this; nothing changed on the row. If you need the moment a code becomes redeemable, schedule against starts_at.
• Re-activating a switched-off coupon does not reset its counts. Redemptions taken before it was switched off still count against max_redemptions, so a code that was exhausted before is still exhausted after.
• Idempotent flips still emit. Activating an already-active coupon over the API emits this again. De-dup on the event id.

Related events

• coupon.deactivated: the paired transition.
• coupon.updated: a terms change, which deliberately excludes this flip.

Header Parameters

The signed JSON envelope posted to your endpoint.

Response Body