Adds the Product Catalog Import API v2

What’s new

Adds the Product Catalog Import API v2 for uploading product catalog data through CSV files. You can now create, retrieve, and list product catalog imports using the new ProductCatalogImport resource.

The API supports CSV files up to 4GB in size and provides a single-step upload process for various feed types. After creating an import, you can track its progress through webhook events including:

• v2.commerce.product_catalog.imports.processing Sent when the file is received and has started processing
• v2.commerce.product_catalog.imports.succeeded Sent when the import completes with no validation errors
• v2.commerce.product_catalog.imports.succeeded_with_errors Sent when the import completes but has validation errors
• v2.commerce.product_catalog.imports.failed Sent when the import can’t complete processing

Impact

You can now programmatically import large product catalogs without having to split your catalog and upload through separate API calls. This helps reduce the time and steps needed to set up product catalogs for large inventories, during both initial setup and bulk updates.

The webhook events allow you to build automated workflows that respond to import completion, enabling you to trigger downstream processes such as inventory synchronization or catalog validation after the import finishes.

To learn more, see Sell through agents.

Changes

Upgrade

1. View your current API version in Workbench.
2. 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. dahlia

3. Upgrade the API version used for webhook endpoints .
4. Test your integration against the new version.
5. If you use Connect, test your Connect integration .
6. In Workbench, perform the upgrade . You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.