Import Operations

Overview

The Import API allows you to bulk import and update products, stock levels, and images through file uploads or XML payloads. Import operations are processed asynchronously in the background, making them ideal for bulk data operations.

Import operations support two formats:

• File Upload: Upload CSV or XLSX files for bulk operations
• XML Payload: Send XML data directly in the request body for programmatic imports

All import operations return immediately with job information, and processing happens asynchronously. Processing time depends on file size and can range from milliseconds to several minutes.

Important:

• Only send changed data when performing bulk operations to optimize performance
• Split large requests into manageable chunks
• Monitor import status using the returned feedId or feedUuid
• File uploads accept .csv or .xlsx extensions
• XML endpoints require text/xml content type header

Update Products by File Upload

POST /v2/import/product-update

Summary: Update the products by uploading the file

Description: This endpoint allows you to update multiple products by uploading a CSV or XLSX file. The import file is processed in the background, meaning your request returns immediately with job information about the scheduled import task.

The endpoint has no limit on the amount of products in a request, however it is recommended to:

• Send only products that have changes
• Avoid sending products without updates
• Split large requests into smaller chunks for better performance

Note:

• Supported file formats: .csv or .xlsx
• Processing happens asynchronously in the background
• Use the returned feedId or feedUuid to track import status
• Processing time varies based on file size (milliseconds to minutes)

Create Products by File Upload

POST /v2/import/product-creation

Summary: Create products by uploading the file

Description: Create multiple products by uploading a CSV or XLSX file. The import file is processed in the background, and your request returns immediately with job information about the scheduled import task.

This endpoint is ideal for bulk product creation when you have product data in spreadsheet format. Processing time depends on the size of the imported file and can range from milliseconds to several minutes.

Note:

• Supported file formats: .csv or .xlsx
• Processing happens asynchronously in the background
• Use the returned feedId or feedUuid to track import status

Create Products by XML

POST /v2/import/product-creation-xml-import

Summary: Create the products by sending XML in the request body

Description: The request body should contain valid XML data with products to import. Each product is represented by a Product element within a Request wrapper. The endpoint accepts and sends only text/xml content type.

Note:

• Request and response bodies use text/xml
• Wrap products in <Request><Product>...</Product></Request>

Update Products by XML

POST /v2/import/product-update-xml-import

Summary: Update the products by sending XML in the request body

Description: The request body should contain valid XML data with product updates to import. Each request can include any of the product fields you want to update. The endpoint accepts and sends only text/xml content type.

Note:

• Request and response bodies use text/xml
• Wrap products in <Request><Product>...</Product></Request>

Remove Products by File Upload

POST /v2/import/product-removal

Summary: Remove products by uploading the file

Description: Remove multiple products by uploading a CSV or XLSX file containing the products to be removed. The import file is processed in the background, and your request returns immediately with job information about the scheduled removal task.

Note:

• Supported file formats: .csv or .xlsx
• Processing happens asynchronously in the background
• Use the returned feedId or feedUuid to track removal status
• Processing time varies based on file size (milliseconds to minutes)

Update Product Stock by File Upload

POST /v2/import/stock-update

Summary: Update the products by uploading the file

Description: Update product stock levels by uploading a CSV or XLSX file. The import file is processed in the background, and your request returns immediately with job information about the scheduled stock update task.

This endpoint has no limit on the amount of products in a request, however it is recommended to:

• Send only products that have stock changes
• Avoid sending products without stock updates
• Split large requests into smaller chunks for better performance

Note:

• Supported file formats: .csv or .xlsx
• Processing happens asynchronously in the background
• Use the returned feedId or feedUuid to track stock update status
• Processing time varies based on file size (milliseconds to minutes)

Update Product Stock by XML

POST /v2/import/product-stock-update-xml

Summary: Update the product stocks by sending XML in the request body

Description: The request body should contain valid XML data with stock updates to import. Each product is represented by a Product element within a Request wrapper, including SellerSku and Quantity. The endpoint accepts and sends only text/xml content type.

This endpoint has no limit on the amount of products in a request. It is recommended to send only products with stock changes, avoid products without stock updates, and split large requests into smaller chunks.

Note:

• Request and response bodies use text/xml
• Wrap products in <Request><Product>...</Product></Request>

Update Product Images by File Upload

POST /v2/import/image-update

Summary: Update the products' images by uploading the file

Description: Update product images by uploading a CSV or XLSX file. The import file is processed in the background, and your request returns immediately with job information about the scheduled image update task.

Note:

• Supported file formats: .csv or .xlsx
• Processing happens asynchronously in the background
• Use the returned feedId or feedUuid to track image update status
• Processing time varies based on file size (milliseconds to minutes)

User Import Operations

Execute API Key Removal Import

POST /v2/users/import/api_keys/removal

Summary: Execute API key removal import

Description: Remove API keys in bulk by uploading a file containing the API keys to be removed.

Execute Seller Access Import

POST /v2/users/import/seller_access

Summary: Execute seller access import

Description: Import seller access permissions in bulk by uploading a file containing the access data.

Import User Status

POST /v2/users/import/status

Summary: Import user status

Description: Update user statuses in bulk by uploading a file containing the user status updates.