All Docs
Getting StartedCalmony PayUpdated March 14, 2026

v1.0.12: Subscription lifecycle webhooks are here

v1.0.12: Subscription lifecycle webhooks are here

Calmony Pay v1.0.12 brings full subscription lifecycle visibility to your webhook endpoints. Starting with this release, your application can receive real-time events for every meaningful state change a subscription goes through — from creation to cancellation — and be notified immediately when a payment fails.

What's shipped

Four new webhook events are now dispatched automatically:

  • subscription.created — fires when a subscription is first created.
  • subscription.updated — fires whenever a subscription is modified.
  • subscription.deleted — fires when a subscription is cancelled.
  • invoice.payment_failed — fires when the billing cron fails to collect payment on a subscription invoice.

Why it matters

Before this release, building reactive subscription logic required polling the Calmony Pay API. Now your application can be event-driven across the entire subscription lifecycle:

  • Provision or deprovision access the moment a subscription status changes.
  • Kick off a dunning flow as soon as a payment failure occurs — without waiting for the next API poll.
  • Keep your own database in sync with Calmony Pay subscriptions without building a reconciliation job.

Getting started

No changes are required to existing webhook endpoints. To receive the new events, subscribe your endpoint to one or more of the new event types in the Calmony Pay dashboard or via the Webhooks API.

See the Subscription Lifecycle Webhooks page for full event schemas and recommended handling patterns.