Payload

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

subscriptionIdstring

The subscription ID.

publicIdstring

The public-facing subscription ID.

customerIdstring

The customer ID.

externalIdstring | null

Your external ID for this customer.

statusstring

The subscription status.

currentPeriodStartstring | null

ISO 8601 start of the current billing period.

currentPeriodEndstring | null

ISO 8601 end of the current billing period.

namestring | null

The customer display name.

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",
  "data": {
    "subscriptionId": "sub_1a2b3c4d",
    "publicId": "sub_pub_5e6f7g",
    "customerId": "cus_8h9i0j",
    "externalId": "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"
  }
}