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.

logo_url behaves as on the single-seller endpoint (mirrored and re-hosted by Mondu, kept when omitted), with one difference: a logo that cannot be fetched does not fail the batch. That row comes back with status: error and a logo resolution failed: … message in its errors array, while the remaining rows are still upserted.

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

Unique seller identifier set by the merchant. Used as the upsert key — cannot be changed after creation.

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
^[^@\s]+@[^@\s]+$
string | null

Publicly reachable https URL of the seller logo (PNG or JPEG, max 5 MB). Mondu downloads the image and re-hosts it, so seller reads return the Mondu-hosted URL and not the one you submitted. Re-sending an unchanged URL is a no-op; omitting the field keeps the seller current logo. An unreachable URL or a file that is not a PNG or JPEG fails the request with 422.

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