coupon.deactivated

When this fires

A creator switched a coupon off — from the dashboard, the Telegram bot, or POST /v1/projects/{project}/coupons/{coupon}/deactivate.

This is the safe way to retire a code, and the one Subscriby points creators at when a delete is refused. Switching off stops the code being offered immediately without touching the redemptions already recorded against it.

Required ability

project-coupon:view — token must carry this at mint time to subscribe an endpoint to this event.

Payload

{
  "id": "evt_01HX...",
  "type": "coupon.deactivated",
  "created_at": "2026-12-01T08:02:19Z",
  "api_version": "2026-05-01",
  "project_id": "prj_01HX...",
  "data": {
    "coupon": {
      "id": "cpn_01HX...",
      "code": "BLACKFRIDAY",
      "name": "Black Friday 2026",
      "discount_type": "percentage",
      "discount_value": "25.0000",
      "currency_id": null,
      "duration": "once",
      "max_redemptions": 500,
      "max_redemptions_per_user": 1,
      "minimum_amount": null,
      "starts_at": "2026-11-27T00:00:00+00:00",
      "expires_at": "2026-12-01T00:00:00+00:00",
      "active": false
    }
  }
}

data.coupon is the same snapshot every coupon.* lifecycle event carries — see coupon.created for each key. active is always false here.

Caveats

• Expiry does not emit this. A coupon that runs past its expires_at stops applying but its active flag never changes, so no event fires. If you need the expiry moment, schedule against expires_at.
• Exhaustion does not emit this either. A coupon that runs out of uses emits coupon.exhausted and stays active: true. The two are distinct states: one is a decision, the other an outcome.
• Nothing is refunded or revoked. Subscribers who already redeemed keep what they paid, and their subscriptions are untouched.

Related events

• coupon.activated — the paired transition.
• coupon.exhausted — ran out of uses rather than being switched off.
• coupon.deleted — the destructive alternative, which takes the history with it.
• Coupon events overview — back to family overview.