Webhook Events

The system emits events for all significant operations. Each organization can subscribe to the relevant types.

Payload Format

{
  "id": "9f8b2c14-3a5d-4e77-9b10-2c6e5f0a1d33",
  "type": "payment.succeeded",
  "created_at": "2026-04-05T10:30:00.000Z",
  "data": { },
  "changes": {
    "status": { "from": "open", "to": "paid" }
  },
  "environment": "production",
  "version": "2026-03-01"
}

• id is the event UUID and created_at is ISO 8601 (UTC). Every envelope field uses snake_case.
• data carries the resource serialized in the same format as the v1 API, also in snake_case.
• changes is optional: it shows up on events that carry field changes (.db.updated and *.status_changed), in the format {"field": {"from": oldValue, "to": newValue}}.

Event Types

Subscriptions (11 types)

Event	Description
subscription.db.created	Subscription created
subscription.db.updated	Subscription updated
subscription.db.deleted	Subscription deleted
subscription.status_changed	Status changed
subscription.canceled	Canceled
subscription.paused	Paused
subscription.resumed	Resumed
subscription.renewed	Renewed
subscription.trial_ending	Trial about to expire
subscription.past_due	Past due

Invoices (10 types)

Event	Description
invoice.db.created	Invoice created
invoice.db.updated	Invoice updated
invoice.db.deleted	Invoice deleted
invoice.status_changed	Status changed
invoice.finalized	Finalized
invoice.paid	Paid
invoice.payment_failed	Payment failed
invoice.voided	Voided
invoice.uncollectible	Marked as uncollectible
invoice.overdue	Overdue

Payments (8 types)

Event	Description
payment.db.created	Payment created
payment.db.updated	Payment updated
payment.db.deleted	Payment deleted
payment.status_changed	Status changed
payment.processing	Processing
payment.succeeded	Succeeded
payment.failed	Failed
payment.refunded	Refunded

Payment Methods (5 types)

Event	Description
payment_method.db.created	Method created
payment_method.db.updated	Method updated
payment_method.db.deleted	Method removed
payment_method.status_changed	Status changed
payment_method.expired	Expired

Plans (4 types)

Event	Description
plan.db.created	Plan created
plan.db.updated	Plan updated
plan.db.deleted	Plan deleted
plan.archived	Plan archived

Products (6 types)

Event	Description
product.db.created	Product created
product.db.updated	Product updated
product.db.deleted	Product deleted
product.status_changed	Status changed
product.archived	Archived
product.restored	Restored

Billing Accounts (5 types)

Event	Description
billing_account.db.created	Account created
billing_account.db.updated	Account updated
billing_account.db.deleted	Account deleted
billing_account.status_changed	Status changed
billing_account.suspended	Account suspended

Company, Customers, and Others

• company.db.created / db.updated / db.deleted / status_changed
• customer.db.created / db.updated / db.deleted

Total: 56 event types