Adds mode property and promotion feed type support to the Product Catalogue Import API v2
What’s new
Adds the mode property to the Product Catalogue 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 catalogue data.
Impact
You can now read the mode property on the Product Catalogue 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 Catalogue Imports v2 with the promotion feed type to centralise 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 .
Learn more about Stripe API upgrades.