trial.converted

{ "event": "trial.converted", "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": "active", "planId": "pln_pro_monthly", "planName": "Pro" } }

When this fires

A customer on a trial changes plan before the trial runs out. The trial ends immediately, the full new plan price is charged (no proration credit — trials are free), and the subscription becomes active.

subscription.plan_changed fires alongside this event with the charge details. Use trial.converted for conversion analytics and lifecycle messaging; use subscription.plan_changed for entitlement updates.

Trials that simply run out fire trial.expired instead — that is the natural trial-to-paid transition.

Body

application/json

string

required

event

string

required

Allowed value: "trial.converted"

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.converted

When this fires

Body

Response

​When this fires

Body

Response

When this fires