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.
Each row becomes one order, so a row’s product_urls may list at most 10
products — a row with more fails validation with
Order cannot contain more than 10 items. A batch itself may contain at most
500 rows.Unrecognized columns are preserved as passthrough data on each row and
echoed back in the results CSV.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Zinc Docs","colors":{"primary":"#386DF0","light":"#FFFEF9","dark":"#292724"},"logo":{"light":"https://mintcdn.com/zinc/exQ2EzxrXSSg0dh-/logo/light.png?fit=max\u0026auto=format\u0026n=exQ2EzxrXSSg0dh-\u0026q=85\u0026s=633d13238d6799080400fbb91b9d08b7","dark":"https://mintcdn.com/zinc/exQ2EzxrXSSg0dh-/logo/dark.png?fit=max\u0026auto=format\u0026n=exQ2EzxrXSSg0dh-\u0026q=85\u0026s=2838196e697c37fe7cdfd161d33f0650","href":"https://zinc.com"},"favicon":"https://mintcdn.com/zinc/6WBnGJAdgAZ2bveD/favicon.svg?fit=max\u0026auto=format\u0026n=6WBnGJAdgAZ2bveD\u0026q=85\u0026s=ff98cf52a415bcea465dcad9a6720435","navbar":{"links":[{"href":"mailto:support@zinc.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.zinc.com"}},"contextual":{"options":["copy","chatgpt","claude"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"zinc","hasAudioNarration":false,"actualSubdomain":"zinc","customDomains":["www.zinc.com"],"gitSource":{"type":"github","owner":"zincio","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae12fbd86cea4b1941cd1d5","collectionId":"f145eba8-1239-4e4f-80c2-8aaca95fc2c7","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae12fbd86cea4b1941cd1d5"},"feedback":{"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6ae12fbd86cea4b1941cd1d5","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"API Reference","count":83},{"language":"default","tag":"Guides","count":22},{"language":"default","tag":"Orders","count":14},{"language":"default","tag":"Object Reference","count":13},{"language":"default","tag":"Objects","count":13},{"language":"default","tag":"Getting Started","count":11},{"language":"default","tag":"Cases","count":8},{"language":"default","tag":"Agent Sandbox","count":8},{"language":"default","tag":"Product Data","count":7},{"language":"default","tag":"Introduction","count":5}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#footer{display:none}:root{--primary:56 109 240;--primary-light:255 254 249;--primary-dark:41 39 36;--background-light:255 254 249;--background-dark:41 39 36;--grey-900:#29272480!important}"},{"filePath":"custom.css","content":"table th{text-align:left!important}.frame{background-color:rgba(255,254,249,.5)!important}.dark .frame{background-color:rgba(41,39,36,.25)!important}.frame [class*=bg-grid]{display:none!important}h3+.frame img,h3+.frame video{aspect-ratio:2048/1350!important;object-fit:contain;width:100%}"}],"page":{"pagePath":"v2/api-reference/orders/create-bulk-upload","slug":"/v2/api-reference/orders/create-bulk-upload","pageMetadata":{"title":"Create Bulk Upload","description":"Place many orders at once by uploading a CSV batch to the Zinc API.","openapi":"versions/latest.json POST /orders/bulk","href":"/v2/api-reference/orders/create-bulk-upload"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Place many orders at once by uploading a CSV batch to the Zinc API.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Info}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Create a bulk-upload batch from parsed CSV rows. The batch is accepted\nimmediately and its rows are placed as individual orders asynchronously.`}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`Validate the upload first with\n`,_jsx(_components.a,{href:`/v2/api-reference/orders/validate-bulk-upload`,children:`Validate Bulk Upload`}),` — it\nreports per-row errors and estimated spend without placing anything.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`request`,children:`Request`}),`\n`,_jsx(_components.p,{children:`The request body is identical to the validate endpoint:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`filename`}),` `,_jsx(_components.em,{children:`(optional)`}),` — Original uploaded filename, for display.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`rows`}),` — Array of objects, one per CSV row, mapping column header to cell value.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Each row becomes one order, so a row’s `,_jsx(_components.code,{children:`product_urls`}),` may list at most `,_jsx(_components.strong,{children:`10`}),`\nproducts — a row with more fails validation with\n`,_jsx(_components.code,{children:`Order cannot contain more than 10 items`}),`. A batch itself may contain at most\n`,_jsx(_components.strong,{children:`500 rows`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Unrecognized columns are preserved as `,_jsx(_components.code,{children:`passthrough`}),` data on each row and\nechoed back in the `,_jsx(_components.a,{href:`/v2/api-reference/orders/download-bulk-results`,children:`results CSV`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(_components.p,{children:[`Returns the new batch with `,_jsx(_components.code,{children:`status: \"pending\"`}),`. Track progress by polling\n`,_jsx(_components.a,{href:`/v2/api-reference/orders/get-bulk-upload`,children:`Get Bulk Upload`}),`:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`id`}),` — Batch UUID.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`status`}),` — `,_jsx(_components.code,{children:`pending`}),` → `,_jsx(_components.code,{children:`processing`}),` → `,_jsx(_components.code,{children:`completed`}),` (or `,_jsx(_components.code,{children:`failed`}),`).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`row_count`}),` / `,_jsx(_components.strong,{children:`placed_count`}),` / `,_jsx(_components.strong,{children:`failed_count`}),` — Row tallies, updated as\nrows are processed.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Each successfully placed row becomes a regular order — it appears in\n`,_jsx(_components.a,{href:`/v2/api-reference/orders/list-orders`,children:`List Orders`}),` and emits the usual\n`,_jsx(_components.a,{href:`/v2/api-reference/introduction/webhooks`,children:`webhook events`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create Bulk Upload","description":"Place many orders at once by uploading a CSV batch to the Zinc API.","openapi":"versions/latest.json POST /orders/bulk","href":"/v2/api-reference/orders/create-bulk-upload"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Request","slug":"request","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["orders"],"summary":"Create Bulk Upload","description":"Place many orders at once by uploading a CSV batch to the Zinc API.","operationId":"create_bulk_upload_orders_bulk_post","parameters":["99ccf01b-a94a-49dc-845f-efc4bfe4b53d"],"requestBody":"4de4d9a1-315c-40a3-b336-005dca26916d","responses":{"201":"5497e684-b59d-42f7-a9bf-470a186c5542","422":"912e0031-5e34-428c-a4e7-1e516aca554d"},"method":"post","type":"path","servers":["1d58a2c1-4356-4539-8def-25bfc550565e"],"security":["99a34ae5-47f5-4f08-8759-e7ea144203fb"],"path":"/orders/bulk","baseUrlOptions":["https://api.zinc.com"],"title":"Create Bulk Upload","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"99ccf01b-a94a-49dc-845f-efc4bfe4b53d":{"name":"authorization","in":"header","required":false,"schema":{"oneOf":[{"type":"string","title":"Authorization","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Authorization","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"filename":{"oneOf":[{"type":"string","title":"Filename","description":"Original uploaded filename, for display.","uniqueKey":"filename.oneOf.0","typeLabel":"string"},{"type":"null","title":"Filename","description":"Original uploaded filename, for display.","uniqueKey":"filename.oneOf.1","typeLabel":"null"}],"uniqueKey":"filename","typeLabel":"string | null"},"rows":{"items":{"additionalProperties":true,"type":"object","uniqueKey":"rows.items.[INDEX]","typeLabel":"object"},"type":"array","title":"Rows","description":"Parsed CSV rows, each a mapping of column header to cell value.","uniqueKey":"rows","typeLabel":"Rows · object[]"},"notify_on_complete":{"type":"boolean","title":"Notify On Complete","description":"Email the account holder once every order in this batch has reached a terminal state (placed, failed, or cancelled).","default":false,"uniqueKey":"notify_on_complete","typeLabel":"boolean"}},"type":"object","title":"BulkUploadRequest","description":"Raw CSV rows (header -> cell) posted from the dashboard.","uniqueKey":"","typeLabel":"BulkUploadRequest · object"},"examples":{"Example":{"title":"Example","value":{"filename":"\u003cstring>","rows":[{}],"notify_on_complete":false}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"5497e684-b59d-42f7-a9bf-470a186c5542":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","enum":["pending","processing","completed","failed"],"title":"BulkBatchStatus","description":"Lifecycle of a CSV bulk-upload batch.","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"row_count":{"type":"integer","title":"Row Count","isRequired":true,"uniqueKey":"row_count","typeLabel":"integer"},"placed_count":{"type":"integer","title":"Placed Count","isRequired":true,"uniqueKey":"placed_count","typeLabel":"integer"},"failed_count":{"type":"integer","title":"Failed Count","isRequired":true,"uniqueKey":"failed_count","typeLabel":"integer"},"created_at":{"type":"string","format":"date-time","title":"Created At","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","isRequired":true,"uniqueKey":"updated_at","typeLabel":"string\u003cdate-time>"},"filename":{"oneOf":[{"type":"string","title":"Filename","uniqueKey":"filename.oneOf.0","typeLabel":"string"},{"type":"null","title":"Filename","uniqueKey":"filename.oneOf.1","typeLabel":"null"}],"uniqueKey":"filename","typeLabel":"string | null"},"notify_on_complete":{"type":"boolean","title":"Notify On Complete","default":false,"uniqueKey":"notify_on_complete","typeLabel":"boolean"},"notified_at":{"oneOf":[{"type":"string","title":"Notified At","format":"date-time","uniqueKey":"notified_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Notified At","uniqueKey":"notified_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"notified_at","typeLabel":"string\u003cdate-time> | null"},"rows":{"items":{"properties":{"index":{"type":"integer","title":"Index","isRequired":true,"uniqueKey":"rows.items.[INDEX].index","typeLabel":"integer"},"status":{"type":"string","title":"Status","description":"placed | failed | pending","isRequired":true,"uniqueKey":"rows.items.[INDEX].status","typeLabel":"string"},"order_id":{"oneOf":[{"type":"string","title":"Order Id","uniqueKey":"rows.items.[INDEX].order_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Order Id","uniqueKey":"rows.items.[INDEX].order_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"rows.items.[INDEX].order_id","typeLabel":"string | null"},"order_status":{"oneOf":[{"type":"string","title":"Order Status","uniqueKey":"rows.items.[INDEX].order_status.oneOf.0","typeLabel":"string"},{"type":"null","title":"Order Status","uniqueKey":"rows.items.[INDEX].order_status.oneOf.1","typeLabel":"null"}],"uniqueKey":"rows.items.[INDEX].order_status","typeLabel":"string | null"},"error":{"oneOf":[{"type":"string","title":"Error","uniqueKey":"rows.items.[INDEX].error.oneOf.0","typeLabel":"string"},{"type":"null","title":"Error","uniqueKey":"rows.items.[INDEX].error.oneOf.1","typeLabel":"null"}],"uniqueKey":"rows.items.[INDEX].error","typeLabel":"string | null"},"recipient":{"oneOf":[{"type":"string","title":"Recipient","uniqueKey":"rows.items.[INDEX].recipient.oneOf.0","typeLabel":"string"},{"type":"null","title":"Recipient","uniqueKey":"rows.items.[INDEX].recipient.oneOf.1","typeLabel":"null"}],"uniqueKey":"rows.items.[INDEX].recipient","typeLabel":"string | null"},"product_urls":{"items":{"type":"string","uniqueKey":"rows.items.[INDEX].product_urls.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Product Urls","uniqueKey":"rows.items.[INDEX].product_urls","typeLabel":"string[]"},"passthrough":{"additionalProperties":true,"type":"object","title":"Passthrough","uniqueKey":"rows.items.[INDEX].passthrough","typeLabel":"Passthrough · object"}},"type":"object","required":["index","status"],"title":"BulkRowResult","description":"Per-row outcome once a batch has been (or is being) processed.","uniqueKey":"rows.items.[INDEX]","typeLabel":"BulkRowResult · object"},"type":"array","title":"Rows","uniqueKey":"rows","typeLabel":"BulkRowResult · object[]"}},"type":"object","required":["id","status","row_count","placed_count","failed_count","created_at","updated_at"],"title":"BulkBatchResponse","description":"A bulk-upload batch and (on the detail endpoint) its per-row results.","uniqueKey":"","typeLabel":"BulkBatchResponse · object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","status":"pending","row_count":123,"placed_count":123,"failed_count":123,"created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z","filename":"\u003cstring>","notify_on_complete":false,"notified_at":"2023-11-07T05:31:56Z","rows":[{"index":123,"status":"\u003cstring>","order_id":"\u003cstring>","order_status":"\u003cstring>","error":"\u003cstring>","recipient":"\u003cstring>","product_urls":["\u003cstring>"],"passthrough":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"912e0031-5e34-428c-a4e7-1e516aca554d":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"99a34ae5-47f5-4f08-8759-e7ea144203fb":{"BearerAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Zinc API key (Bearer zn_...)","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"1d58a2c1-4356-4539-8def-25bfc550565e":{"url":"https://api.zinc.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","description":"Zinc API key (Bearer zn_...)","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Authorization","type":"string","description":"Zinc API key (Bearer zn_...)","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"versions/latest.json"},"subdomain":"zinc","siteName":"Zinc Docs","title":"Create Bulk Upload - Zinc Docs","navMaps":{"firstHrefInVersion":{"v1":{"href":"/v1","matchLevel":4},"v2 - 2026-10-26":{"href":"/v2/api-reference/orders/create-bulk-upload","matchLevel":0}},"firstHrefInLanguage":{}},"lastModified":"2026-08-27T22:21:07.597Z","originalFileLocation":"v2/api-reference/orders/create-bulk-upload.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Place many orders at once by uploading a CSV batch to the Zinc API.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Zinc Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/zinc/_LtPLM5Rgn46vKzY/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/zinc/_LtPLM5Rgn46vKzY/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/zinc/_LtPLM5Rgn46vKzY/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/zinc/_LtPLM5Rgn46vKzY/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/zinc/_LtPLM5Rgn46vKzY/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/zinc/_LtPLM5Rgn46vKzY/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/zinc/_LtPLM5Rgn46vKzY/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/zinc/_LtPLM5Rgn46vKzY/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/zinc/_LtPLM5Rgn46vKzY/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Bulk Upload - Zinc Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Place many orders at once by uploading a CSV batch to the Zinc API.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Zinc Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.zinc.com/docs/v2/api-reference/orders/create-bulk-upload\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://zinc.mintlify.app/_mintlify/api/og/v2?division=Bulk+Orders\u0026amp;title=Create+Bulk+Upload\u0026amp;description=Place+many+orders+at+once+by+uploading+a+CSV+batch+to+the+Zinc+API.\u0026amp;theme=f2b55f0bf154012a40eb6c4a\u0026amp;signature=af58158c15d46df7a2e409477911fae69c0a3228e9af4dcf15f7b807a6ee17a8\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create Bulk Upload - Zinc Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Place many orders at once by uploading a CSV batch to the Zinc API.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://zinc.mintlify.app/_mintlify/api/og/v2?division=Bulk+Orders\u0026amp;title=Create+Bulk+Upload\u0026amp;description=Place+many+orders+at+once+by+uploading+a+CSV+batch+to+the+Zinc+API.\u0026amp;theme=f2b55f0bf154012a40eb6c4a\u0026amp;signature=af58158c15d46df7a2e409477911fae69c0a3228e9af4dcf15f7b807a6ee17a8\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/zinc/_LtPLM5Rgn46vKzY/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Zinc Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#386DF0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.zinc.com/docs/v2/api-reference/orders/create-bulk-upload\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/v2/api-reference/orders/create-bulk-upload.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.zinc.com/#organization\",\"name\":\"Zinc Docs\",\"url\":\"https://www.zinc.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/zinc/exQ2EzxrXSSg0dh-/logo/light.png?fit=max\u0026auto=format\u0026n=exQ2EzxrXSSg0dh-\u0026q=85\u0026s=633d13238d6799080400fbb91b9d08b7\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.zinc.com/docs#website\",\"name\":\"Zinc Docs\",\"url\":\"https://www.zinc.com/docs\",\"publisher\":{\"@id\":\"https://www.zinc.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.zinc.com/docs/v2/api-reference/orders/create-bulk-upload#webpage\",\"url\":\"https://www.zinc.com/docs/v2/api-reference/orders/create-bulk-upload\",\"name\":\"Create Bulk Upload\",\"description\":\"Place many orders at once by uploading a CSV batch to the Zinc API.\",\"dateModified\":\"2026-08-27T22:21:07.597Z\",\"isPartOf\":{\"@id\":\"https://www.zinc.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.zinc.com/docs/v2/api-reference/orders/create-bulk-upload#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.zinc.com/docs/v2/api-reference/orders/create-bulk-upload#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Bulk Orders\",\"item\":\"https://www.zinc.com/docs/v2/api-reference/orders/validate-bulk-upload\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Bulk Upload\",\"item\":\"https://www.zinc.com/docs/v2/api-reference/orders/create-bulk-upload\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.zinc.com/docs/v2/api-reference/orders/create-bulk-upload#apireference\",\"headline\":\"Create Bulk Upload\",\"name\":\"Create Bulk Upload\",\"description\":\"Place many orders at once by uploading a CSV batch to the Zinc API.\",\"url\":\"https://www.zinc.com/docs/v2/api-reference/orders/create-bulk-upload\",\"mainEntityOfPage\":{\"@id\":\"https://www.zinc.com/docs/v2/api-reference/orders/create-bulk-upload#webpage\"},\"dateModified\":\"2026-08-27T22:21:07.597Z\",\"publisher\":{\"@id\":\"https://www.zinc.com/#organization\"},\"isPartOf\":{\"@id\":\"https://www.zinc.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Zinc Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Zinc Docs","nav":{"global":null,"versions":[{"version":"v1","pages":[{"title":"v1","href":"/v1"}]},{"version":"v2 - 2026-10-26","default":true,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]},{"tab":"API Reference","groups":[{"group":"Getting Started","pages":[{"title":"Authentication","icon":"key","href":"/v2/api-reference/introduction/authentication"},{"title":"Idempotency","icon":"repeat-1","href":"/v2/api-reference/introduction/idempotency"},{"title":"Sandbox \u0026 Testing","icon":"flask-vial","href":"/v2/api-reference/introduction/sandbox"},{"title":"Error Handling","icon":"triangle-exclamation","href":"/v2/api-reference/introduction/error-handling"},{"title":"Webhooks","icon":"bell","href":"/v2/api-reference/introduction/webhooks"},{"title":"API Changelog","icon":"code-compare","href":"/v2/api-reference/introduction/api-changelog"}]},{"group":"Agent Sandbox","pages":[{"title":"Agent Sandbox","sidebarTitle":"Overview","icon":"robot","href":"/v2/api-reference/sandbox/overview"},{"title":"Mint a Sandbox Key","openapi":"versions/latest.json POST /sandbox/keys","href":"/v2/api-reference/sandbox/mint-sandbox-key"},{"title":"Agent Quickstart","openapi":"versions/latest.json GET /sandbox/quickstart","href":"/v2/api-reference/sandbox/get-agent-quickstart"},{"title":"Claim a Sandbox","openapi":"versions/latest.json POST /sandbox/claim","href":"/v2/api-reference/sandbox/claim-sandbox"},{"title":"Get Sandbox Status","openapi":"versions/latest.json GET /sandbox/status","href":"/v2/api-reference/sandbox/get-sandbox-status"}]},{"group":"Device Approval","pages":[{"title":"Start a Device Code","openapi":"versions/latest.json POST /device/code","href":"/v2/api-reference/device/start-device-code"},{"title":"Redeem a Device Code","openapi":"versions/latest.json POST /device/token","href":"/v2/api-reference/device/redeem-device-code"},{"title":"Describe a Device Code","openapi":"versions/latest.json GET /device/codes/{user_code}","href":"/v2/api-reference/device/describe-device-code"},{"title":"Approve a Device Code","openapi":"versions/latest.json POST /device/approve","href":"/v2/api-reference/device/approve-device-code"}]},{"group":"Search (Beta)","pages":[{"title":"Cross-Retailer Search","openapi":"versions/latest.json GET /search","href":"/v2/api-reference/search/cross-retailer"}]},{"group":"Orders","pages":[{"title":"Create Order","openapi":"versions/latest.json POST /orders","href":"/v2/api-reference/orders/create-order"},{"title":"List Orders","openapi":"versions/latest.json GET /orders","href":"/v2/api-reference/orders/list-orders"},{"title":"Get Order","openapi":"versions/latest.json GET /orders/{order_id}","href":"/v2/api-reference/orders/get-order"},{"title":"Get Order Timeline","openapi":"versions/latest.json GET /orders/{order_id}/timeline","href":"/v2/api-reference/orders/get-order-timeline"},{"title":"Cancel Order","openapi":"versions/latest.json POST /orders/{order_id}/cancel","href":"/v2/api-reference/orders/cancel-order"},{"title":"Order Tracking","icon":"truck-fast","href":"/v2/api-reference/orders/tracking"},{"title":"Get Public Tracking","openapi":"versions/latest.json GET /track/{order_id}","href":"/v2/api-reference/orders/get-public-tracking"},{"title":"Export Orders","openapi":"versions/latest.json GET /orders/export","href":"/v2/api-reference/orders/export-orders"},{"title":"The Products Array","icon":"boxes-stacked","href":"/v2/api-reference/orders/multiple-products-quantities"}]},{"group":"Bulk Orders","pages":[{"title":"Validate Bulk Upload","description":"Validate a CSV bulk upload with the Zinc API before placing any real orders.","openapi":"versions/latest.json POST /orders/bulk/validate","href":"/v2/api-reference/orders/validate-bulk-upload"},{"title":"Create Bulk Upload","openapi":"versions/latest.json POST /orders/bulk","href":"/v2/api-reference/orders/create-bulk-upload"},{"title":"List Bulk Uploads","description":"List all bulk upload batches placed through your Zinc account.","openapi":"versions/latest.json GET /orders/bulk","href":"/v2/api-reference/orders/list-bulk-uploads"},{"title":"Get Bulk Upload","openapi":"versions/latest.json GET /orders/bulk/{batch_id}","href":"/v2/api-reference/orders/get-bulk-upload"},{"title":"Download Bulk Results","openapi":"versions/latest.json GET /orders/bulk/{batch_id}/results.csv","href":"/v2/api-reference/orders/download-bulk-results"}]},{"group":"Managed Accounts","pages":[{"title":"List Managed Accounts","openapi":"versions/latest.json GET /managed-accounts","href":"/v2/api-reference/managed-accounts/list-managed-accounts"},{"title":"Create Managed Account","openapi":"versions/latest.json POST /managed-accounts","href":"/v2/api-reference/managed-accounts/create-managed-account"},{"title":"Update Managed Account","openapi":"versions/latest.json PUT /managed-accounts/{short_id}","href":"/v2/api-reference/managed-accounts/update-managed-account"},{"title":"Delete Managed Account","openapi":"versions/latest.json DELETE /managed-accounts/{short_id}","href":"/v2/api-reference/managed-accounts/delete-managed-account"},{"title":"Retailer Credentials","sidebarTitle":"Configuration","icon":"key-skeleton","href":"/v2/api-reference/configuration/managed-accounts"}]},{"group":"Returns","pages":[{"title":"Create Return Request","openapi":"versions/latest.json POST /returns","href":"/v2/api-reference/returns/create-return"},{"title":"List Return Requests","openapi":"versions/latest.json GET /returns","href":"/v2/api-reference/returns/list-returns"},{"title":"Get Return Request","openapi":"versions/latest.json GET /returns/{return_request_id}","href":"/v2/api-reference/returns/get-return"}]},{"group":"Cases","pages":[{"title":"Create Case","openapi":"versions/latest.json POST /cases","href":"/v2/api-reference/cases/create-case"},{"title":"List Cases","openapi":"versions/latest.json GET /cases","href":"/v2/api-reference/cases/list-cases"},{"title":"Get Case","openapi":"versions/latest.json GET /cases/{case_id}","href":"/v2/api-reference/cases/get-case"},{"title":"Post Case Message","openapi":"versions/latest.json POST /cases/{case_id}/messages","href":"/v2/api-reference/cases/post-case-message"},{"title":"Close Case","openapi":"versions/latest.json POST /cases/{case_id}/close","href":"/v2/api-reference/cases/close-case"}]},{"group":"Product Data","pages":[{"title":"Search Products","openapi":"versions/latest.json GET /products/search","href":"/v2/api-reference/products/search"},{"title":"Get Product Details","openapi":"versions/latest.json GET /products/{product_id}","href":"/v2/api-reference/products/get-product"},{"title":"Get Product Offers","openapi":"versions/latest.json GET /products/{product_id}/offers","href":"/v2/api-reference/products/get-product-offers"},{"title":"Get Wishlist","openapi":"versions/latest.json GET /products/wishlists","href":"/v2/api-reference/products/get-wishlist"}]},{"group":"Retailers","pages":[{"title":"List Retailers","openapi":"versions/latest.json GET /retailers","href":"/v2/api-reference/retailers/list-retailers"},{"title":"Check a Retailer","openapi":"versions/latest.json GET /retailers/check","href":"/v2/api-reference/retailers/check-retailer"}]},{"group":"Agent","pages":[{"title":"Create Agent Order","openapi":"versions/latest.json POST /agent/orders","href":"/v2/api-reference/agent/create-order"},{"title":"Agent Search","openapi":"versions/latest.json POST /agent/search","href":"/v2/api-reference/agent/search"},{"title":"Agent Product Search","openapi":"versions/latest.json POST /agent/products/search","href":"/v2/api-reference/agent/product-search"},{"title":"Agent Product Offers","openapi":"versions/latest.json POST /agent/products/offers","href":"/v2/api-reference/agent/product-offers"},{"title":"Agent Product Details","openapi":"versions/latest.json POST /agent/products/details","href":"/v2/api-reference/agent/product-details"}]},{"group":"Wallet","pages":[{"title":"Get Wallet","openapi":"versions/latest.json GET /wallet/me","href":"/v2/api-reference/wallet/get-wallet"}]},{"group":"Webhooks","pages":[{"title":"Get Webhook Endpoint","openapi":"versions/latest.json GET /webhooks/endpoint","href":"/v2/api-reference/webhooks/get-webhook-endpoint"},{"title":"Set Webhook Endpoint","openapi":"versions/latest.json PUT /webhooks/endpoint","href":"/v2/api-reference/webhooks/set-webhook-endpoint"},{"title":"Clear Webhook Endpoint","openapi":"versions/latest.json DELETE /webhooks/endpoint","href":"/v2/api-reference/webhooks/clear-webhook-endpoint"}]},{"group":"Usage","pages":[{"title":"Get My Usage","openapi":"versions/latest.json GET /usage","href":"/v2/api-reference/usage/get-my-usage"}]}]}]}]},"title":"Create Bulk Upload - Zinc Docs","buildId":"dpl_DGmhKsAzJdVqypJzon18vViniWRY","deploymentId":"dpl_DGmhKsAzJdVqypJzon18vViniWRY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-2jF_ccbi.js","utils-NNMVb_sb.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DdtBhtt6.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D1OxL5O8.js","snippetPresets-DDC-KAXp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BOnTqOyQ.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-EEWI6FIO.js","shallow-fGZcWzm2.js","getApiPlaygroundDisplay-B3B8qEvw.js","CodeSnippet-BG9nsSU4.js","CodeSnippets-BlRACLKl.js","Page-FtoC8lZ9.js","getPastedJson-COV-Kgnr.js","icon-BXu3lasn.js","MethodPill-DGMUqJKh.js","DuplicateIcon-JEUJDHz_.js","createIcon-BDFucJ34.js","DynamicMarkdown-34OtG_BH.js","SectionHeading-tBbRD59j.js","axios-vUo_bRtp.js","Markdown-SoRz2nk2.js","clsx-BOmkPVIU.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DN0dCbTw.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BcsLYcfW.js"]}