trial.started

{ "event": "trial.started", "timestamp": "2026-06-23T14:30:00.000Z", "organizationId": "8f14e45f-ceea-4e7a-9c3d-1c2b3a4d5e6f", "mode": "live", "apiVersion": "2026-08-27", "data": { "subscriptionId": "sub_1a2b3c4d", "customerId": "user_123", "status": "trialing", "planId": "pln_pro_monthly", "planName": "Pro", "trialEndsAt": "2026-04-08T00:00:00.000Z" } }

Trial lifecycle

A trial either saves a payment method at checkout or, when the price’s trial requires none, starts at once without checkout:

Moment	Event	What to do
The trial checkout completes, or a trial without a payment method starts	`trial.started`	Grant full access.
3 days before the trial ends	`trial.will_end`	Remind the customer billing starts soon.
Customer upgrades during the trial	`trial.converted`	Trial ends early, paid plan starts now.
Trial runs out	`trial.expired`	With a payment method, regular billing begins. Without one, the subscription moves to the plan group’s default plan or is canceled.

Subscriptions with status: "trialing" have full access — treat them like active in your entitlement checks. While a trial without a payment method has no card, the subscription’s hasPaymentMethod is false.

Body

application/json

string

required

event

string

required

Allowed value: "trial.started"

timestamp

string

required

organizationId

string

required

mode

enum<string>

required

Available options:

live,

sandbox

apiVersion

string

required

data

object

required

Show child attributes

Response

200

Return any 2xx status code to acknowledge receipt of the event.

Overview

Events

Trial lifecycle

Body

Response

​Trial lifecycle

Body

Response

Trial lifecycle