> ## Documentation Index
> Fetch the complete documentation index at: https://commet.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# trial.started

> Fired when a subscription enters its trial period, after checkout or at once when the price's trial requires no payment method. Grant access here.

## 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`.


## OpenAPI

````yaml /openapi/en/webhooks/2026-08-27.json webhook trial.started
openapi: 3.1.0
info:
  title: Commet Webhooks
  version: '2026-08-27'
  description: >-
    Outbound webhook events emitted by the Commet API. Each event is delivered
    as a signed POST to your configured endpoints.
servers: []
security: []
paths: {}

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.