---
title: "Imports products from an Excel file"
method: POST
path: "/api/v{version}/products/import"
tags: ["catalog"]
---

# Imports products from an Excel file

`POST /api/v{version}/products/import`

Imports products using an Excel file. Supports two formats: 1) multipart/form-data with 'file' field (recommended, more efficient), 2) JSON body with 'excelFileBase64' (legacy). Optionally provide a dictionary of columns and their matching propertyNames.

## Path parameters

- `version` string, required

## Headers

- `X-Tenant` string, required

## Response `200`

OK

- ProductImportResult
  - `succeededs` SucceededImportProductResult[], nullable
    - `rowIndex` integer
    - `productId` string, uuid
  - `faileds` FailedImportProductResult[], nullable
    - `rowIndex` integer
    - `errorMessage` string, nullable

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/zrexpress/apis/zrexpress-api.md) · [All operations](https://skmtc.dev/zrexpress/apis/zrexpress-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zrexpress/zrexpress-api/revisions/99b075e0b641/schema)