Skip to content

Subscription Schedule ​

A subscription schedule allows you to create and manage the lifecycle of a subscription by predefining expected changes.

Related guide: Subscription schedules

Endpoints ​

Create a schedule ​

  • POST /v1/subscription_schedules

Update a schedule ​

  • POST /v1/subscription_schedules/:id

Retrieve a schedule ​

  • GET /v1/subscription_schedules/:id

List all schedules ​

  • GET /v1/subscription_schedules

Cancel a schedule ​

  • POST /v1/subscription_schedules/:id/cancel

Release a schedule ​

  • POST /v1/subscription_schedules/:id/release

Events ​

  • subscription_schedule.aborted Occurs whenever a subscription schedule is canceled due to the underlying subscription being canceled because of delinquency.

  • subscription_schedule.canceled Occurs whenever a subscription schedule is canceled.

  • subscription_schedule.completed Occurs whenever a new subscription schedule is completed.

  • subscription_schedule.created Occurs whenever a new subscription schedule is created.

  • subscription_schedule.expiring Occurs 7 days before a subscription schedule will expire.

  • subscription_schedule.released Occurs whenever a new subscription schedule is released.

  • subscription_schedule.updated Occurs whenever a subscription schedule is updated.

Stripe API Reference - Self-contained docs reference, refreshed 2026-05-18