# Adds the Product Catalog Import API v2

## What’s new

Adds the [Product Catalog Import API v2](https://docs.stripe.com/api/v2/commerce/product-catalog-imports.md?api-version=2026-04-22.dahlia) for uploading product catalog data through CSV files. You can now create, retrieve, and list product catalog imports using the new [ProductCatalogImport](https://docs.stripe.com/api/v2/commerce/product-catalog-imports/object.md?api-version=2026-04-22.dahlia) 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](https://docs.stripe.com/api/v2/commerce/product-catalog-imports.md?api-version=2026-04-22.dahlia#v2_product_catalog_imports_event_types-v2.commerce.product_catalog.imports.processing) Sent when the file is received and has started processing
- [v2.commerce.product_catalog.imports.succeeded](https://docs.stripe.com/api/v2/commerce/product-catalog-imports.md?api-version=2026-04-22.dahlia#v2_product_catalog_imports_event_types-v2.commerce.product_catalog.imports.succeeded) Sent when the import completes with no validation errors
- [v2.commerce.product_catalog.imports.succeeded_with_errors](https://docs.stripe.com/api/v2/commerce/product-catalog-imports.md?api-version=2026-04-22.dahlia#v2_product_catalog_imports_event_types-v2.commerce.product_catalog.imports.succeeded_with_errors) Sent when the import completes but has validation errors
- [v2.commerce.product_catalog.imports.failed](https://docs.stripe.com/api/v2/commerce/product-catalog-imports.md?api-version=2026-04-22.dahlia#v2_product_catalog_imports_event_types-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.

## Changes

#### REST API

|  | Change | Resource                                                                                                                                           |
|  | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [V2.Commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

| Endpoints                    | Change | Resource                                                                                                                                           |
| ---------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create`, `retrieve`, `list` | Added  | [V2.Commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

|                                                                                                                                                                                                            | Change | Event type                         |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------- |
| `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` | Added  | `V2.Commerce.ProductCatalogImport` |

#### Ruby

|  | Change | Resource                                                                                                                                             |
|  | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [V2::Commerce::ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

| Methods              | Change | Resource                                                                                                                                             |
| -------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create`, `retrieve` | Added  | [V2::Commerce::ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

|                                                                                                                                                                                                            | Change | Event type                           |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ------------------------------------ |
| `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` | Added  | `V2::Commerce::ProductCatalogImport` |

#### Python

|  | Change | Resource                                                                                                                                           |
|  | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [v2.commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

| Methods              | Change | Resource                                                                                                                                           |
| -------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create`, `retrieve` | Added  | [v2.commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

|                                                                                                                                                                                                            | Change | Event type                         |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------- |
| `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` | Added  | `v2.commerce.ProductCatalogImport` |

#### PHP

|  | Change | Resource                                                                                                                                           |
|  | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [V2.Commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

| Methods              | Change | Resource                                                                                                                                           |
| -------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create`, `retrieve` | Added  | [V2.Commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

|                                                                                                                                                                                                            | Change | Event type                         |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------- |
| `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` | Added  | `V2.Commerce.ProductCatalogImport` |

#### Java

|  | Change | Resource                                                                                                                                           |
|  | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [v2.commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

| Methods              | Change | Resource                                                                                                                                           |
| -------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create`, `retrieve` | Added  | [v2.commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

|                                                                                                                                                                                                            | Change | Event type                         |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------- |
| `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` | Added  | `v2.commerce.ProductCatalogImport` |

#### Node.js

|  | Change | Resource                                                                                                                                           |
|  | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [V2.Commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

| Methods              | Change | Resource                                                                                                                                           |
| -------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create`, `retrieve` | Added  | [V2.Commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

|                                                                                                                                                                                                            | Change | Event type                         |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------- |
| `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` | Added  | `V2.Commerce.ProductCatalogImport` |

#### Go

|  | Change | Resource                                                                                                                                         |
|  | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
|  | Added  | [V2CommerceProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

| Methods      | Change | Resource                                                                                                                                         |
| ------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Get`, `New` | Added  | [V2CommerceProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

|                                                                                                                                                                                                            | Change | Event type                       |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | -------------------------------- |
| `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` | Added  | `V2CommerceProductCatalogImport` |

#### .NET

|  | Change | Resource                                                                                                                                           |
|  | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [V2.Commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

| Methods         | Change | Resource                                                                                                                                           |
| --------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Create`, `Get` | Added  | [V2.Commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

|                                                                                                                                                                                                            | Change | Event type                         |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------- |
| `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` | Added  | `V2.Commerce.ProductCatalogImport` |

## Upgrade

#### REST API

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
1. 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](https://docs.stripe.com/api/versioning.md) to include `Stripe-Version: 2026-04-22.dahlia`
1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
1. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Ruby

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
1. Upgrade your Ruby SDK to the latest version.
1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
1. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Python

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
1. Upgrade your Python SDK to the latest version.
1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
1. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### PHP

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
1. Upgrade your PHP SDK to the latest version.
1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
1. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Java

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
1. Upgrade your Java SDK to the latest version.
1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
1. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Node.js

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
1. Upgrade your Node SDK to the latest version.
1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
1. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Go

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
1. Upgrade your Go SDK to the latest version.
1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
1. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### .NET

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
1. Upgrade your .NET SDK to the latest version.
1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
1. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).