trial.will_end

{ "event": "trial.will_end", "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" } }

When this fires

A daily scan finds trials ending within the next 3 days and emits this event once per trial. The idempotency key is derived from the subscription and the trial end date, so re-running the scan never sends a duplicate.

Use it to remind the customer that billing starts on trialEndsAt — the single most effective moment to prevent involuntary churn and surprise charges.

If the trial end date changes after this event fired (for example, the customer converts early), trial.converted or trial.expired reflects the final outcome.

Body

application/json

string

required

event

string

required

Allowed value: "trial.will_end"

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

When this fires

Body

Response

​When this fires

Body

Response

When this fires