Payload

All webhook payloads follow a consistent top-level structure with event-specific data nested within the data object.

subscriptionIdstring

The subscription ID.

customerIdstring

The customer ID. Returns your externalId if you provided one when creating the customer, otherwise returns the Commet publicId.

statusstring

Current status. One of: draft, pending_payment, trialing, active, past_due, canceled. Access is granted while trialing, active, or past_due — past_due is a permissive grace window during dunning, where you decide whether to keep serving the customer or block them.

currentPeriodStartstring | null

ISO 8601 start of the current billing period.

currentPeriodEndstring | null

ISO 8601 end of the current billing period.

namestring | null

Optional custom name for the subscription.

invoiceIdstring

The invoice ID for this payment.

invoiceNumberstring

The human-readable invoice number.

invoiceTotalnumber

Invoice total in cents (100 = $1.00).

invoiceCurrencystring

The invoice currency code.

{
  "event": "subscription.activated",
  "timestamp": "2026-03-25T14:32:00.000Z",
  "organizationId": "org_abc123",
  "mode": "live",
  "apiVersion": "2026-05-25",
  "data": {
    "subscriptionId": "sub_1a2b3c4d",
    "customerId": "user_123",
    "status": "active",
    "currentPeriodStart": "2026-03-25T00:00:00.000Z",
    "currentPeriodEnd": "2026-04-25T00:00:00.000Z",
    "name": "Acme Corp",
    "invoiceId": "inv_k1l2m3",
    "invoiceNumber": "INV-0042",
    "invoiceTotal": 9900,
    "invoiceCurrency": "usd"
  }
}