Public preview
Adds programmatic invocation of Stripe Workflows Public preview
What’s new
This change adds new APIs to work with Stripe Workflows. You can now list, retrieve and programmatically invoke workflows created through the Dashboard. Previously, workflows could only be triggered by Stripe events.
This change also adds methods to list and retrieve workflow runs, including events emitted during a workflow run’s lifecycle.
Impact
You can now integrate workflow execution into your application’s logic, enabling use cases such as:
- Starting workflows in response to user actions within your application
- Triggering workflows as part of batch processing operations
- Triggering workflows in response to the success or failure of other workflows
You can now monitor workflow runs from within your own application. Subscribe to workflow run lifecycle events to be notified or take actions in response to the status of workflow runs.
Changes
| Change | Resources | |
|---|---|---|
| Added | V2. Extend. Workflow V2. Extend. WorkflowRun | |
| Endpoints | Change | Resources |
| list retrieve | Added | V2. Extend. WorkflowRun |
| invoke list retrieve | Added | V2. Extend. Workflow |
| Change | Event type | |
| V2ExtendWorkflowRunFailedEvent V2ExtendWorkflowRunStartedEvent V2ExtendWorkflowRunSucceededEvent | Added | V2.Extend.WorkflowRun |
Upgrade
- 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: 2026-04-22. preview
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
Learn more about Stripe API upgrades.