Skip to main content
POST
Bulk Import Products from 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 containing product rows.

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.

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