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 eventsWebhook event
Active subscription createdSubscription Activated
Future subscription createdSubscription Created
Trial started, trial activatedTrial Subscription
Trial ending soonSubscription Trial Ending Soon
Subscription renewedSubscription Renewed
Upgrade, downgrade, plan changed, frequency changed, add-on added, add-ons updated, trial extended, reactivated, scheduled change cancelled, change mandate requiredSubscription Changed
Change scheduled, frequency change scheduled, add-on scheduledSubscription Scheduled Change
Paused / resumedSubscription Paused / Subscription Resumed
Cancelled / scheduled for cancellationSubscription Cancelled / Subscription Scheduled Cancellation
Expired / expiring soonSubscription Expired / Subscription Expiring Soon
Post cancellationPost Cancellation
Invoice created, paid, due soon, overdueInvoice … events
Payment successful, failed, scheduled retry, final failurePayment Successful, Payment Failed, Payment Retry Attempt, Payment Final Failure
Refund issued, credit note issuedRefund Issued, Credit Note Issued
Card expiry approaching, card updated, payment method expired or invalid, payment method missingPayment Method … events
Immediate payment request, auto-debit reminderPayment Request Created, Auto Debit Reminder
Dunning reminders, login and profile eventsNo 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.