Subscription Lifecycle Actions
Actions for Subscription Lifecycle. Every other area is listed on the Action Hooks Reference. Each name links to its own page, with its parameters, notes and an example.
Fire when a subscriber’s membership changes state on the connected bridge — activated, cancelled, moved to a different tier, renewed, or failed to pay.
| Hook | Description |
|---|---|
benecaster_subscription_activated |
Fires when a subscriber becomes active on any bridge |
benecaster_subscription_synced |
Fires when Sync Existing Members, mapping a level, or a MemberPress or WooCommerce Subscriptions renewal links somebody who already belonged to the membership plugin, instead of benecaster_subscription_activated; receives $user_id, $show_id, $tier_slug, $started_at |
benecaster_subscription_cancelled |
Fires when any bridge reports a subscription has been cancelled |
benecaster_subscription_tier_changed |
Fires when a built-in-membership subscriber moves from one tier to another, or an admin changes their tier; sends the Tier Change email. Not fired for a membership plugin’s plan change |
benecaster_subscription_tier_moved |
Fires once whenever a subscriber holds a different tier, whatever reported it — membership plugin, built-in membership or admin; sends nothing. Rank the move with benecaster_compare_tiers() |
benecaster_subscription_free_switch_scheduled |
Fires when a built-in-membership subscriber chooses the show’s free plan; the move lands at their renewal |
benecaster_subscription_free_switch_landed |
Fires when that move lands: the subscriber is on the free tier with the same feed URL |
benecaster_subscription_free_switch_cancelled |
Fires when that move is withdrawn before it lands, by the subscriber or by cancelling their membership |
benecaster_subscription_renewed |
Fires when a built-in-membership subscription renews or its billing state changes without a tier change. Not fired for a membership plugin’s renewal |
benecaster_subscription_payment_failed |
Fires on the first failed payment of a billing retry cycle, while the subscriber keeps their feed. When the retries run out, benecaster_subscription_cancelled fires instead (on built-in membership, the subscription moves to unpaid) |
See Also
Need this built rather than just documented? See our services →