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"
        }
      ]
    }
  ]
}
'

{
  "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"
        }
      ]
    }
  ]
}

Products

Bulk upload products (Beta)

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:

product_family_id — Redo product family ID (direct lookup)
external_id — ID from your external system
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 --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"
        }
      ]
    }
  ]
}
'

{
  "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

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

Update Fulfillment Status