Improved
previous payload object now available in the `subscription/updated` webhook
March 11th, 2026
The subscription/updated webhook now includes a previous object in the payload, giving you a snapshot of the subscription's state before the change was applied.
What's New?
You can now compare the previous and current state of a subscription directly from the webhook payload - no database required. The previous object is available across the following changes:
- Line actions - swap, quantity update, product added or removed (for both subscription and one-time lines)
- Discount actions - discount added or removed
- Policy updates - changes to billing policy or delivery policy on a subscription contract
Why this matters
This is especially useful if you're running automations or workflows based on subscription changes but don't maintain your own database. With the previous object, you can now detect exactly what changed and trigger the right action downstream - without needing to store or compare historical states yourself.