Bulk register sellers

Registers up to 100 sellers in a single request. Each row is upserted by external_reference_id, with the same semantics as the single-seller endpoint: existing rows are updated, new rows are inserted.

The response always returns 200 OK with a per-row status of created, updated, or error. Use total_created, total_updated, and total_errors for at-a-glance counts.

Validation is all-or-nothing for missing or malformed fields: if any row fails schema validation (required fields, format rules, etc.) the whole batch is rejected with 400 or 422. Per-row error statuses are reserved for downstream persistence failures after schema validation has passed.

Validation error responses include the offending row index in the response keys (e.g. sellers[3].company_address.address_line1) so you can identify which row failed.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
sellers
array of objects
required
length between 1 and 100
sellers*
string
required
length between 1 and 255

Reference ID of resource in external service

string
required
length between 1 and 255

Legal name of the seller company.

company_address
object
required
string

Trade registry or business registration number of the seller.

string

VAT identification number of the seller.

string
Responses

400

Malformed JSON, missing sellers array, or per-row schema validation failure

401

Invalid or missing API key

422

Batch-level validation failed (size > 100 or duplicate external_reference_id within the request)

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json