Removes iterations parameter for subscription schedulesBreaking changes

What’s new

We’ve removed the iterations parameter because duration replaces its functionality.

You can no longer specify the length of subscription schedule phase using the iterations parameter in these following API endpoints:

Use duration instead of iterations to create or update subscription schedules.

Parameter	Change	Resources or endpoints
iterations	Removed	Invoice#create_preview.schedule_details.phases[]SubscriptionSchedule#create.phases[]SubscriptionSchedule#update.phases[]

View your current API version in Workbench.
If you use an SDK, upgrade to the corresponding SDK version for this API version.
- If you don’t use an SDK, update your API requests to include Stripe-Version: 2025-08-27.preview
Upgrade the API version used for webhook endpoints.
Test your integration against the new version.
If you use Connect, test your Connect integration.
In Workbench, perform the upgrade. You can roll back the version for 72 hours.