Event Model
Last reviewed: 16 November 2026
When something happens in BillHive, a business event is raised. Each business event can produce up to three outputs:
- Email uses the template whose trigger is the event, if the notification is on. See Notifications & Email.
- Webhook is sent when the business event maps to a webhook event and you subscribed to it. Several business events share one webhook event.
- Delivery happens asynchronously after the action completes.
Business event to webhook event
| Business events | Webhook event |
|---|---|
| Active subscription created | Subscription Activated |
| Future subscription created | Subscription Created |
| Trial started, trial activated | Trial Subscription |
| Trial ending soon | Subscription Trial Ending Soon |
| Subscription renewed | Subscription Renewed |
| Upgrade, downgrade, plan changed, frequency changed, add-on added, add-ons updated, trial extended, reactivated, scheduled change cancelled, change mandate required | Subscription Changed |
| Change scheduled, frequency change scheduled, add-on scheduled | Subscription Scheduled Change |
| Paused / resumed | Subscription Paused / Subscription Resumed |
| Cancelled / scheduled for cancellation | Subscription Cancelled / Subscription Scheduled Cancellation |
| Expired / expiring soon | Subscription Expired / Subscription Expiring Soon |
| Post cancellation | Post Cancellation |
| Invoice created, paid, due soon, overdue | Invoice … events |
| Payment successful, failed, scheduled retry, final failure | Payment Successful, Payment Failed, Payment Retry Attempt, Payment Final Failure |
| Refund issued, credit note issued | Refund Issued, Credit Note Issued |
| Card expiry approaching, card updated, payment method expired or invalid, payment method missing | Payment Method … events |
| Immediate payment request, auto-debit reminder | Payment Request Created, Auto Debit Reminder |
| Dunning reminders, login and profile events | No webhook |
Payload and delivery details: Webhook.
Activity log
Subscription actions are also written to the subscription’s Activity Log, including actions that were discarded because a newer one replaced them. Use it as the audit trail.