Skip to main content
POST
Bulk Import Products from JSON or CSV

Authorizations

Authorization
string
header
required

Bearer API key for server-to-server access. Session auth is also supported in first-party UI flows.

Body

file
file
required

CSV file or JSON array containing product rows. JSON object files may wrap the array as products.

targetMarketplaces
required

Comma-separated marketplace list, e.g. shopee,lazada.

targetCountries
required

Comma-separated country list, e.g. sg,my.

organizationId
string

Optional for API-key requests; required for session-authenticated requests across multiple organizations.

fileName
string

Optional display name override. Defaults to the uploaded file name.

fieldMapping
string

JSON object mapping CSV headers to import fields, e.g. {"sku":"SKU","title":"Product Name"}.

marketplaceStoreSelections
string

JSON object mapping marketplace keys to connected store IDs.

selectedRowIndexes
string

JSON array of zero-based CSV row indexes to import.

lane
enum<string>
Available options:
standard,
enterprise
dedupPolicy
enum<string>
Available options:
keep_first,
keep_last,
merge_fields_prefer_non_empty,
fail_job
autoApproveThreshold

Optional confidence threshold between 0 and 1, or the string null.

spendCeilingUsd
model
string

Optional enrichment model override.

imageAnnotationTemplateId
string<uuid>
imageAnnotationScope
enum<string>
Available options:
primary,
all_gallery
workflow
string

JSON object with enrichment workflow options such as sourceImagesAutomatically, enableRichDescription, and autoAssignMarketplaceTaxonomy.

Response

Bulk import workflow accepted

ok
boolean
apiVersion
string
default:developer_v1
operationId
string
status
string
jobId
string

Bulk import job ID with bulk_ prefix.

warnings
string[]
recommendations
string[]
data
object