Bulk upload products

Bulk create or update product families and their variants.

Submit up to 1,000 product families per request, each containing up to 100 variants. Products are processed asynchronously in batches. Only one bulk upload can run per store at a time.

Matching Strategy

The API uses the following priority to match incoming product families to existing records:

1. product_family_id — Redo product family ID (direct lookup)
2. external_id — ID from your external system
3. SKU — Matched via variant SKUs

If no match is found, a new product family is created.

Concurrency

Only one bulk upload operation can run per store at a time. If a bulk upload is already in progress, the request will return a 409 Conflict error.

Requires the products_write scope.