Adds mode property and promotion feed type support to the Product Catalog Import API v2
What’s new
Adds the mode property to the Product Catalog Import v2 object. This property returns the import mode that was used when the import was created, either replace or upsert.
Also adds support for setting feed_type to promotion. You can now import promotional data feeds, including discounts and offers, alongside your existing product catalog data.
Impact
You can now read the mode property on the Product Catalog Import object to determine whether an import used replace or upsert mode so you can distinguish between imports when reviewing their results.
You can also create Product Catalog Imports v2 with the promotion feed type to centralize your promotional data in the same import workflow you use for products, without requiring a separate integration path.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| mode | Added | V2. Commerce. ProductCatalogImport |
| Value | Change | Enum |
| promotion | Added | V2. Commerce. ProductCatalogImport. feed_type |
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-06-24. dahlia
- 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.
Learn more about Stripe API upgrades.