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.

POST /stores/{storeId}/products/bulk-upload

cURL

single_product

curl --request POST \
  --url https://api.getredo.com/v2.2/stores/{storeId}/products/bulk-upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "products": [
    {
      "title": "Classic T-Shirt",
      "description": "A comfortable cotton t-shirt",
      "vendor": "Acme Apparel",
      "tags": [
        "apparel",
        "basics"
      ],
      "kind": "SELLABLE",
      "variants": [
        {
          "sku": "TSHIRT-BLK-M",
          "price": 2999,
          "currency": "USD",
          "weight": 200,
          "weight_unit": "g"
        }
      ]
    }
  ]
}
'

200

success

{
  "total_count": 2,
  "processed_count": 2,
  "error_count": 0,
  "results": [
    {
      "status": "created",
      "product_family_id": "01H5K3EXAMPLE1",
      "products": [
        {
          "id": "01H5K3EXAMPLE1A",
          "sku": "SHOE-BLK-9"
        },
        {
          "id": "01H5K3EXAMPLE1B",
          "sku": "SHOE-WHT-10"
        }
      ]
    },
    {
      "status": "updated",
      "product_family_id": "01H5K3EXAMPLE2",
      "products": [
        {
          "id": "01H5K3EXAMPLE2A",
          "sku": "SOCK-WHT-L"
        }
      ]
    }
  ]
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

storeId · string · required

Store ID

Example:

"64e5a8a1af49a89df37e4ee7"

Body

application/json

Request body for bulk uploading product families and their variants.

products · Bulk Product Family · object[] · required

Product families to create or update. Between 1 and 1000 per request.

Required array length: 1 - 1000 elements

Show child attributes

Response

200

application/json

Upload completed

Response from a bulk product upload operation.

total_count · integer · required

Total number of product families in the request.

processed_count · integer · required

Number of product families processed successfully.

error_count · integer · required

Number of product families that failed to process.

results · (Success Result · object | Error Result · object)[] · required

Per-product-family results.

A product family that was created or updated successfully.

Success Result

Error Result

Show child attributes