Create Bulk Upload
Bulk Orders
Create Bulk Upload
Place many orders at once from a CSV upload
POST
Create Bulk Upload
Create a bulk-upload batch from parsed CSV rows. The batch is accepted
immediately and its rows are placed as individual orders asynchronously.
Validate the upload first with
Validate Bulk Upload — it
reports per-row errors and estimated spend without placing anything.
Request
The request body is identical to the validate endpoint:- filename (optional) — Original uploaded filename, for display.
- rows — Array of objects, one per CSV row, mapping column header to cell value.
passthrough data on each row and
echoed back in the results CSV.
Response
Returns the new batch withstatus: "pending". Track progress by polling
Get Bulk Upload:
- id — Batch UUID.
- status —
pending→processing→completed(orfailed). - row_count / placed_count / failed_count — Row tallies, updated as rows are processed.
Authorizations
Zinc API key (Bearer zn_...)
Headers
Body
application/json
Response
Successful Response
A bulk-upload batch and (on the detail endpoint) its per-row results.
Lifecycle of a CSV bulk-upload batch.
Available options:
pending, processing, completed, failed 
