Event: subscription.created

Dispatched when a subscription becomes active or trial with a payment method associated (checkout completed or API create flow).

Schema definition

Same data shape as all subscription events. Optional fields reason and effective_at are omitted on this event.

Loading ....

Example

{
  "event_type": "subscription.created",
  "subscription_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "customer_id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
  "plan_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "merchant_id": "2e0b4f5a-8c3d-4e1f-9a2b-1c3d4e5f6a7b",
  "status": "active",
  "current_period_start": "2026-05-21T00:00:00Z",
  "current_period_end": "2026-06-21T00:00:00Z",
  "next_billing_date": "2026-06-22T03:00:00Z",
  "external_reference": "ORDER-1001"
}