Queue a bulk product import for the authenticated organization.
Input options
Upload a CSV (2 MiB) or JSON products file (8 MiB) using multipart/form-data.
Send JSON with a products array of 1–5,000 flat product objects (8 MiB request maximum).
Send JSON with inline csvText.
Send JSON referencing a stored documentId.
Asynchronous result
The API creates import rows, then queues draft creation and AI Review through Inngest. Completed import jobs expose reviewBatchIds, reviewUrls, and reviewWarnings; generated changes require Review approval. Poll the returned bulk_... job with GET /api/v1/jobs/{jobId}.
Cancel an in-flight import with POST /api/v1/jobs/{jobId}/cancel.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"OmniCommerce","description":"Developer documentation for OmniCommerce REST APIs, MCP tools, and agent integrations.","colors":{"primary":"#0F766E","light":"#2DD4BF","dark":"#115E59"},"logo":{"light":"https://mintcdn.com/omnicommerce/B2cjFTJ7Zt2npdeV/logo/light.svg?fit=max\u0026auto=format\u0026n=B2cjFTJ7Zt2npdeV\u0026q=85\u0026s=e012509da06089923275e6b0415addf9","dark":"https://mintcdn.com/omnicommerce/B2cjFTJ7Zt2npdeV/logo/dark.svg?fit=max\u0026auto=format\u0026n=B2cjFTJ7Zt2npdeV\u0026q=85\u0026s=547bdf6cb0b483a43238304bc7679fa1","href":"https://omnicommerce.sg"},"favicon":"https://mintcdn.com/omnicommerce/B2cjFTJ7Zt2npdeV/favicon.svg?fit=max\u0026auto=format\u0026n=B2cjFTJ7Zt2npdeV\u0026q=85\u0026s=2951c661b72ccdfa6777f7594193113c","api":{"params":{"expanded":"closed"},"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","javascript","python"],"prefill":false}},"appearance":{"default":"dark"},"navbar":{"links":[{"href":"https://omnicommerce.sg","label":"App"},{"href":"https://omnicommerce.sg/login","label":"Log In"}],"primary":{"type":"button","label":"API Dashboard","href":"https://omnicommerce.sg/app"}},"footer":{"socials":{"website":"https://omnicommerce.sg"}},"seo":{"metatags":{"og:site_name":"OmniCommerce Docs","twitter:card":"summary_large_image"}},"contextual":{"options":["copy","view","chatgpt","claude","download-spec"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"omnicommerce","hasAudioNarration":false,"actualSubdomain":"omnicommerce","customDomains":["docs.omnicommerce.sg"],"gitSource":{"type":"github","owner":"rmdort","repo":"omnicommerce","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6adbd0b266dc5112c9cd1db7","collectionId":"5a8b52fa-144a-4ed2-99bb-c7d4439f5f99","liveDeploymentHistoryId":"6adbd0b266dc5112c9cd1db7","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6adbd0b266dc5112c9cd1db7","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"API Reference","count":141},{"language":"default","tag":"Endpoints","count":119},{"language":"default","tag":"Documentation","count":39},{"language":"default","tag":"Webhooks","count":31},{"language":"default","tag":"Guides","count":18},{"language":"default","tag":"Products","count":18},{"language":"default","tag":"Developer Platform","count":14},{"language":"default","tag":"Orders","count":11},{"language":"default","tag":"Analytics","count":11},{"language":"default","tag":"Promotions","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"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":"editor-v7-file-tree","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":"editor-nav-generations","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":"editor-agent-model-picker","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":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root{--docs-radius:6px;--docs-content-max:60rem;--docs-example-width:28rem}#navbar img[src*=logo],header img[src$=\"/logo/dark.svg\"],header img[src$=\"/logo/light.svg\"],header nav-logo img{height:32px!important;max-height:32px!important;width:auto!important}article p:not(.callout-title):not(.callout-body),main p:not(.callout-title):not(.callout-body){font-size:calc(1em - 1pt)}"}],"page":{"pagePath":"api-reference/products/bulk-import-products-from-json-or-csv","slug":"/api-reference/products/bulk-import-products-from-json-or-csv","pageMetadata":{"title":"Bulk Import Products from JSON or CSV","description":"Queue a bulk product import for the authenticated organization.\n\n### Input options\n\n- Upload a CSV (2 MiB) or JSON products file (8 MiB) using `multipart/form-data`.\n- Send JSON with a `products` array of 1–5,000 flat product objects (8 MiB request maximum).\n- Send JSON with inline `csvText`.\n- Send JSON referencing a stored `documentId`.\n\n### Asynchronous result\n\nThe API creates import rows, then queues draft creation and AI Review through Inngest. Completed import jobs expose `reviewBatchIds`, `reviewUrls`, and `reviewWarnings`; generated changes require Review approval. Poll the returned `bulk_...` job with `GET /api/v1/jobs/{jobId}`.\n\nCancel an in-flight import with `POST /api/v1/jobs/{jobId}/cancel`.","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/products/bulk-import","href":"/api-reference/products/bulk-import-products-from-json-or-csv","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n h3: \"h3\",\n li: \"li\",\n p: \"p\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Queue a bulk product import for the authenticated organization.\"\n }), \"\\n\", _jsx(_components.h3, {\n children: \"Input options\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [\"Upload a CSV (2 MiB) or JSON products file (8 MiB) using \", _jsx(_components.code, {\n children: \"multipart/form-data\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"Send JSON with a \", _jsx(_components.code, {\n children: \"products\"\n }), \" array of 1–5,000 flat product objects (8 MiB request maximum).\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"Send JSON with inline \", _jsx(_components.code, {\n children: \"csvText\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"Send JSON referencing a stored \", _jsx(_components.code, {\n children: \"documentId\"\n }), \".\"]\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.h3, {\n children: \"Asynchronous result\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"The API creates import rows, then queues draft creation and AI Review through Inngest. Completed import jobs expose \", _jsx(_components.code, {\n children: \"reviewBatchIds\"\n }), \", \", _jsx(_components.code, {\n children: \"reviewUrls\"\n }), \", and \", _jsx(_components.code, {\n children: \"reviewWarnings\"\n }), \"; generated changes require Review approval. Poll the returned \", _jsx(_components.code, {\n children: \"bulk_...\"\n }), \" job with \", _jsx(_components.code, {\n children: \"GET /api/v1/jobs/{jobId}\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Cancel an in-flight import with \", _jsx(_components.code, {\n children: \"POST /api/v1/jobs/{jobId}/cancel\"\n }), \".\"]\n })]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Bulk Import Products from JSON or CSV","description":"Queue a bulk product import for the authenticated organization.\n\n### Input options\n\n- Upload a CSV (2 MiB) or JSON products file (8 MiB) using `multipart/form-data`.\n- Send JSON with a `products` array of 1–5,000 flat product objects (8 MiB request maximum).\n- Send JSON with inline `csvText`.\n- Send JSON referencing a stored `documentId`.\n\n### Asynchronous result\n\nThe API creates import rows, then queues draft creation and AI Review through Inngest. Completed import jobs expose `reviewBatchIds`, `reviewUrls`, and `reviewWarnings`; generated changes require Review approval. Poll the returned `bulk_...` job with `GET /api/v1/jobs/{jobId}`.\n\nCancel an in-flight import with `POST /api/v1/jobs/{jobId}/cancel`.","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/products/bulk-import","href":"/api-reference/products/bulk-import-products-from-json-or-csv","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"post_v1_products_bulk_import","summary":"Bulk Import Products from JSON or CSV","description":"Queue a bulk product import for the authenticated organization.\n\n### Input options\n\n- Upload a CSV (2 MiB) or JSON products file (8 MiB) using `multipart/form-data`.\n- Send JSON with a `products` array of 1–5,000 flat product objects (8 MiB request maximum).\n- Send JSON with inline `csvText`.\n- Send JSON referencing a stored `documentId`.\n\n### Asynchronous result\n\nThe API creates import rows, then queues draft creation and AI Review through Inngest. Completed import jobs expose `reviewBatchIds`, `reviewUrls`, and `reviewWarnings`; generated changes require Review approval. Poll the returned `bulk_...` job with `GET /api/v1/jobs/{jobId}`.\n\nCancel an in-flight import with `POST /api/v1/jobs/{jobId}/cancel`.","tags":["products"],"security":["1707e6c5-4fad-4b1f-a950-9e63965eeed5"],"requestBody":"36c5588c-ebb0-404f-a8de-d17517b0bad5","responses":{"202":"31fad7ba-7c82-40ee-932e-8ca0789ef786","400":"3219ce14-7cde-44b4-b843-1ab3edf80e00","401":"a7c5447f-1683-4c35-9849-9a8689095e98","403":"49156310-d583-42c0-afc6-6d2e9477677d","413":"7cc24dd4-d4ff-4213-8349-58c0589df8f2","500":"fdf09805-f6e5-4ea0-9a12-609eb442937b"},"method":"post","type":"path","servers":["39970a03-ff72-4559-a542-364a55d2e30f","1047c457-3777-4869-be4f-4e086fafbbca"],"path":"/api/v1/products/bulk-import","baseUrlOptions":["https://omnicommerce.sg","http://localhost:3000"],"title":"Bulk Import Products from JSON or CSV","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["targetMarketplaces","marketplaceStoreSelections","products"],"properties":{"products":{"minItems":1,"maxItems":5000,"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","minLength":1,"maxLength":200,"isRequired":true,"uniqueKey":"oneOf.0.products.items.[INDEX].sku","typeLabel":"string"},"title":{"type":"string","maxLength":400,"uniqueKey":"oneOf.0.products.items.[INDEX].title","typeLabel":"string"},"gtin":{"type":"string","maxLength":100,"uniqueKey":"oneOf.0.products.items.[INDEX].gtin","typeLabel":"string"},"brand":{"type":"string","maxLength":160,"uniqueKey":"oneOf.0.products.items.[INDEX].brand","typeLabel":"string"},"description":{"type":"string","maxLength":10000,"uniqueKey":"oneOf.0.products.items.[INDEX].description","typeLabel":"string"},"price":{"type":"number","minimum":0,"uniqueKey":"oneOf.0.products.items.[INDEX].price","typeLabel":"number"},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$","uniqueKey":"oneOf.0.products.items.[INDEX].currency","typeLabel":"string"},"compareAtPrice":{"type":"number","minimum":0,"uniqueKey":"oneOf.0.products.items.[INDEX].compareAtPrice","typeLabel":"number"},"salePrice":{"type":"number","minimum":0,"uniqueKey":"oneOf.0.products.items.[INDEX].salePrice","typeLabel":"number"},"costPerItem":{"type":"number","minimum":0,"uniqueKey":"oneOf.0.products.items.[INDEX].costPerItem","typeLabel":"number"},"inventory":{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"oneOf.0.products.items.[INDEX].inventory","typeLabel":"integer"},"images":{"maxItems":30,"type":"array","items":{"type":"string","format":"uri","maxLength":2048,"uniqueKey":"oneOf.0.products.items.[INDEX].images.items.[INDEX]","typeLabel":"string\u003curi>"},"uniqueKey":"oneOf.0.products.items.[INDEX].images","typeLabel":"string\u003curi>[]"},"category":{"type":"string","maxLength":255,"uniqueKey":"oneOf.0.products.items.[INDEX].category","typeLabel":"string"},"categoryName":{"type":"string","maxLength":500,"uniqueKey":"oneOf.0.products.items.[INDEX].categoryName","typeLabel":"string"},"weight":{"type":"number","minimum":0,"uniqueKey":"oneOf.0.products.items.[INDEX].weight","typeLabel":"number"},"dimensions":{"type":"object","properties":{"length":{"type":"number","minimum":0,"isRequired":true,"uniqueKey":"oneOf.0.products.items.[INDEX].dimensions.length","typeLabel":"number"},"width":{"type":"number","minimum":0,"isRequired":true,"uniqueKey":"oneOf.0.products.items.[INDEX].dimensions.width","typeLabel":"number"},"height":{"type":"number","minimum":0,"isRequired":true,"uniqueKey":"oneOf.0.products.items.[INDEX].dimensions.height","typeLabel":"number"}},"required":["length","width","height"],"additionalProperties":false,"uniqueKey":"oneOf.0.products.items.[INDEX].dimensions","typeLabel":"object"}},"required":["sku"],"additionalProperties":false,"uniqueKey":"oneOf.0.products.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.0.products","typeLabel":"object[]"},"targetMarketplaces":{"minItems":1,"type":"array","items":{"type":"string","enum":["shopee","lazada","tiktok","shopify","whatsapp","zalora","amazon","ebay"],"uniqueKey":"oneOf.0.targetMarketplaces.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"oneOf.0.targetMarketplaces","typeLabel":"enum\u003cstring>[]"},"marketplaceStoreSelections":{"type":"object","minProperties":1,"description":"Required: select at least one connected store. One store per marketplace, not an array of store IDs.","properties":{"shopee":{"type":"string","description":"Connected shopee store ID.","uniqueKey":"oneOf.0.marketplaceStoreSelections.shopee","typeLabel":"string"},"lazada":{"type":"string","description":"Connected lazada store ID.","uniqueKey":"oneOf.0.marketplaceStoreSelections.lazada","typeLabel":"string"},"tiktok":{"type":"string","description":"Connected tiktok store ID.","uniqueKey":"oneOf.0.marketplaceStoreSelections.tiktok","typeLabel":"string"},"shopify":{"type":"string","description":"Connected shopify store ID.","uniqueKey":"oneOf.0.marketplaceStoreSelections.shopify","typeLabel":"string"},"whatsapp":{"type":"string","description":"Connected whatsapp store ID.","uniqueKey":"oneOf.0.marketplaceStoreSelections.whatsapp","typeLabel":"string"},"zalora":{"type":"string","description":"Connected zalora store ID.","uniqueKey":"oneOf.0.marketplaceStoreSelections.zalora","typeLabel":"string"},"amazon":{"type":"string","description":"Connected amazon store ID.","uniqueKey":"oneOf.0.marketplaceStoreSelections.amazon","typeLabel":"string"},"ebay":{"type":"string","description":"Connected ebay store ID.","uniqueKey":"oneOf.0.marketplaceStoreSelections.ebay","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.0.marketplaceStoreSelections","typeLabel":"object"},"title":{"oneOf":[{"type":"string","maxLength":120,"uniqueKey":"oneOf.0.title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"oneOf.0.title.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.title","typeLabel":"string | null"},"organizationId":{"type":"string","minLength":1,"maxLength":120,"uniqueKey":"oneOf.0.organizationId","typeLabel":"string"},"csvText":{"type":"string","uniqueKey":"oneOf.0.csvText","typeLabel":"string"},"documentId":{"type":"string","minLength":1,"maxLength":255,"uniqueKey":"oneOf.0.documentId","typeLabel":"string"},"fileName":{"type":"string","maxLength":500,"uniqueKey":"oneOf.0.fileName","typeLabel":"string"},"selectedRowIndexes":{"type":"array","items":{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"oneOf.0.selectedRowIndexes.items.[INDEX]","typeLabel":"integer"},"uniqueKey":"oneOf.0.selectedRowIndexes","typeLabel":"integer[]"},"lane":{"type":"string","enum":["standard","enterprise"],"uniqueKey":"oneOf.0.lane","typeLabel":"enum\u003cstring>"},"targetCountries":{"type":"array","items":{"type":"string","minLength":1,"maxLength":80,"uniqueKey":"oneOf.0.targetCountries.items.[INDEX]","typeLabel":"string"},"uniqueKey":"oneOf.0.targetCountries","typeLabel":"string[]"},"fieldMapping":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"oneOf.0.fieldMapping.additionalProperties","typeLabel":"string"},"uniqueKey":"oneOf.0.fieldMapping","typeLabel":"object"},"dedupPolicy":{"type":"string","enum":["keep_first","keep_last","merge_fields_prefer_non_empty","fail_job"],"uniqueKey":"oneOf.0.dedupPolicy","typeLabel":"enum\u003cstring>"},"autoApproveThreshold":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"oneOf.0.autoApproveThreshold.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"oneOf.0.autoApproveThreshold.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.autoApproveThreshold","typeLabel":"number | null"},"spendCeilingUsd":{"oneOf":[{"type":"number","minimum":0,"uniqueKey":"oneOf.0.spendCeilingUsd.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"oneOf.0.spendCeilingUsd.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.spendCeilingUsd","typeLabel":"number | null"},"model":{"type":"string","minLength":1,"maxLength":120,"uniqueKey":"oneOf.0.model","typeLabel":"string"},"imageAnnotationTemplateId":{"oneOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"oneOf.0.imageAnnotationTemplateId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","uniqueKey":"oneOf.0.imageAnnotationTemplateId.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.imageAnnotationTemplateId","typeLabel":"string\u003cuuid> | null"},"imageAnnotationGalleryTemplateId":{"oneOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"oneOf.0.imageAnnotationGalleryTemplateId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","uniqueKey":"oneOf.0.imageAnnotationGalleryTemplateId.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.imageAnnotationGalleryTemplateId","typeLabel":"string\u003cuuid> | null"},"imageAnnotationScope":{"type":"string","enum":["primary","all_gallery"],"uniqueKey":"oneOf.0.imageAnnotationScope","typeLabel":"enum\u003cstring>"},"workflow":{"type":"object","properties":{"enableRichDescription":{"type":"boolean","uniqueKey":"oneOf.0.workflow.enableRichDescription","typeLabel":"boolean"},"sourceImagesAutomatically":{"type":"boolean","uniqueKey":"oneOf.0.workflow.sourceImagesAutomatically","typeLabel":"boolean"},"autoAssignMarketplaceTaxonomy":{"type":"boolean","uniqueKey":"oneOf.0.workflow.autoAssignMarketplaceTaxonomy","typeLabel":"boolean"},"enableBackgroundRemoval":{"type":"boolean","uniqueKey":"oneOf.0.workflow.enableBackgroundRemoval","typeLabel":"boolean"},"enableMannequinRemoval":{"type":"boolean","uniqueKey":"oneOf.0.workflow.enableMannequinRemoval","typeLabel":"boolean"},"skipImageTagging":{"type":"boolean","uniqueKey":"oneOf.0.workflow.skipImageTagging","typeLabel":"boolean"},"skipZeroInventoryProducts":{"type":"boolean","uniqueKey":"oneOf.0.workflow.skipZeroInventoryProducts","typeLabel":"boolean"},"excludedImageTags":{"oneOf":[{"type":"string","maxLength":2000,"uniqueKey":"oneOf.0.workflow.excludedImageTags.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","minLength":1,"maxLength":120,"uniqueKey":"oneOf.0.workflow.excludedImageTags.oneOf.1.items.[INDEX]","typeLabel":"string"},"maxItems":50,"uniqueKey":"oneOf.0.workflow.excludedImageTags.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"oneOf.0.workflow.excludedImageTags","typeLabel":"string | string[]"},"enabledBuiltInImageTags":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":120,"uniqueKey":"oneOf.0.workflow.enabledBuiltInImageTags.items.[INDEX]","typeLabel":"string"},"uniqueKey":"oneOf.0.workflow.enabledBuiltInImageTags","typeLabel":"string[]"},"customImageTags":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120,"isRequired":true,"uniqueKey":"oneOf.0.workflow.customImageTags.items.[INDEX].name","typeLabel":"string"},"description":{"type":"string","minLength":1,"maxLength":280,"isRequired":true,"uniqueKey":"oneOf.0.workflow.customImageTags.items.[INDEX].description","typeLabel":"string"}},"required":["name","description"],"uniqueKey":"oneOf.0.workflow.customImageTags.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.0.workflow.customImageTags","typeLabel":"object[]"},"enrich":{"type":"boolean","uniqueKey":"oneOf.0.workflow.enrich","typeLabel":"boolean"},"disableAcoGeneration":{"description":"Accepted for compatibility. Bulk import does not queue ACO.","type":"boolean","uniqueKey":"oneOf.0.workflow.disableAcoGeneration","typeLabel":"boolean"},"skipEnrichment":{"type":"boolean","uniqueKey":"oneOf.0.workflow.skipEnrichment","typeLabel":"boolean"},"skipBackgroundRemoval":{"type":"boolean","uniqueKey":"oneOf.0.workflow.skipBackgroundRemoval","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"oneOf.0.workflow","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["targetMarketplaces","marketplaceStoreSelections","csvText"],"properties":{"csvText":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.csvText","typeLabel":"string"},"targetMarketplaces":{"minItems":1,"type":"array","items":{"type":"string","enum":["shopee","lazada","tiktok","shopify","whatsapp","zalora","amazon","ebay"],"uniqueKey":"oneOf.1.targetMarketplaces.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"oneOf.1.targetMarketplaces","typeLabel":"enum\u003cstring>[]"},"marketplaceStoreSelections":{"type":"object","minProperties":1,"description":"Required: select at least one connected store. One store per marketplace, not an array of store IDs.","properties":{"shopee":{"type":"string","description":"Connected shopee store ID.","uniqueKey":"oneOf.1.marketplaceStoreSelections.shopee","typeLabel":"string"},"lazada":{"type":"string","description":"Connected lazada store ID.","uniqueKey":"oneOf.1.marketplaceStoreSelections.lazada","typeLabel":"string"},"tiktok":{"type":"string","description":"Connected tiktok store ID.","uniqueKey":"oneOf.1.marketplaceStoreSelections.tiktok","typeLabel":"string"},"shopify":{"type":"string","description":"Connected shopify store ID.","uniqueKey":"oneOf.1.marketplaceStoreSelections.shopify","typeLabel":"string"},"whatsapp":{"type":"string","description":"Connected whatsapp store ID.","uniqueKey":"oneOf.1.marketplaceStoreSelections.whatsapp","typeLabel":"string"},"zalora":{"type":"string","description":"Connected zalora store ID.","uniqueKey":"oneOf.1.marketplaceStoreSelections.zalora","typeLabel":"string"},"amazon":{"type":"string","description":"Connected amazon store ID.","uniqueKey":"oneOf.1.marketplaceStoreSelections.amazon","typeLabel":"string"},"ebay":{"type":"string","description":"Connected ebay store ID.","uniqueKey":"oneOf.1.marketplaceStoreSelections.ebay","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.marketplaceStoreSelections","typeLabel":"object"},"title":{"oneOf":[{"type":"string","maxLength":120,"uniqueKey":"oneOf.1.title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"oneOf.1.title.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.title","typeLabel":"string | null"},"products":{"minItems":1,"maxItems":5000,"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","minLength":1,"maxLength":200,"isRequired":true,"uniqueKey":"oneOf.1.products.items.[INDEX].sku","typeLabel":"string"},"title":{"type":"string","maxLength":400,"uniqueKey":"oneOf.1.products.items.[INDEX].title","typeLabel":"string"},"gtin":{"type":"string","maxLength":100,"uniqueKey":"oneOf.1.products.items.[INDEX].gtin","typeLabel":"string"},"brand":{"type":"string","maxLength":160,"uniqueKey":"oneOf.1.products.items.[INDEX].brand","typeLabel":"string"},"description":{"type":"string","maxLength":10000,"uniqueKey":"oneOf.1.products.items.[INDEX].description","typeLabel":"string"},"price":{"type":"number","minimum":0,"uniqueKey":"oneOf.1.products.items.[INDEX].price","typeLabel":"number"},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$","uniqueKey":"oneOf.1.products.items.[INDEX].currency","typeLabel":"string"},"compareAtPrice":{"type":"number","minimum":0,"uniqueKey":"oneOf.1.products.items.[INDEX].compareAtPrice","typeLabel":"number"},"salePrice":{"type":"number","minimum":0,"uniqueKey":"oneOf.1.products.items.[INDEX].salePrice","typeLabel":"number"},"costPerItem":{"type":"number","minimum":0,"uniqueKey":"oneOf.1.products.items.[INDEX].costPerItem","typeLabel":"number"},"inventory":{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"oneOf.1.products.items.[INDEX].inventory","typeLabel":"integer"},"images":{"maxItems":30,"type":"array","items":{"type":"string","format":"uri","maxLength":2048,"uniqueKey":"oneOf.1.products.items.[INDEX].images.items.[INDEX]","typeLabel":"string\u003curi>"},"uniqueKey":"oneOf.1.products.items.[INDEX].images","typeLabel":"string\u003curi>[]"},"category":{"type":"string","maxLength":255,"uniqueKey":"oneOf.1.products.items.[INDEX].category","typeLabel":"string"},"categoryName":{"type":"string","maxLength":500,"uniqueKey":"oneOf.1.products.items.[INDEX].categoryName","typeLabel":"string"},"weight":{"type":"number","minimum":0,"uniqueKey":"oneOf.1.products.items.[INDEX].weight","typeLabel":"number"},"dimensions":{"type":"object","properties":{"length":{"type":"number","minimum":0,"isRequired":true,"uniqueKey":"oneOf.1.products.items.[INDEX].dimensions.length","typeLabel":"number"},"width":{"type":"number","minimum":0,"isRequired":true,"uniqueKey":"oneOf.1.products.items.[INDEX].dimensions.width","typeLabel":"number"},"height":{"type":"number","minimum":0,"isRequired":true,"uniqueKey":"oneOf.1.products.items.[INDEX].dimensions.height","typeLabel":"number"}},"required":["length","width","height"],"additionalProperties":false,"uniqueKey":"oneOf.1.products.items.[INDEX].dimensions","typeLabel":"object"}},"required":["sku"],"additionalProperties":false,"uniqueKey":"oneOf.1.products.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.1.products","typeLabel":"object[]"},"organizationId":{"type":"string","minLength":1,"maxLength":120,"uniqueKey":"oneOf.1.organizationId","typeLabel":"string"},"documentId":{"type":"string","minLength":1,"maxLength":255,"uniqueKey":"oneOf.1.documentId","typeLabel":"string"},"fileName":{"type":"string","maxLength":500,"uniqueKey":"oneOf.1.fileName","typeLabel":"string"},"selectedRowIndexes":{"type":"array","items":{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"oneOf.1.selectedRowIndexes.items.[INDEX]","typeLabel":"integer"},"uniqueKey":"oneOf.1.selectedRowIndexes","typeLabel":"integer[]"},"lane":{"type":"string","enum":["standard","enterprise"],"uniqueKey":"oneOf.1.lane","typeLabel":"enum\u003cstring>"},"targetCountries":{"type":"array","items":{"type":"string","minLength":1,"maxLength":80,"uniqueKey":"oneOf.1.targetCountries.items.[INDEX]","typeLabel":"string"},"uniqueKey":"oneOf.1.targetCountries","typeLabel":"string[]"},"fieldMapping":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"oneOf.1.fieldMapping.additionalProperties","typeLabel":"string"},"uniqueKey":"oneOf.1.fieldMapping","typeLabel":"object"},"dedupPolicy":{"type":"string","enum":["keep_first","keep_last","merge_fields_prefer_non_empty","fail_job"],"uniqueKey":"oneOf.1.dedupPolicy","typeLabel":"enum\u003cstring>"},"autoApproveThreshold":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"oneOf.1.autoApproveThreshold.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"oneOf.1.autoApproveThreshold.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.autoApproveThreshold","typeLabel":"number | null"},"spendCeilingUsd":{"oneOf":[{"type":"number","minimum":0,"uniqueKey":"oneOf.1.spendCeilingUsd.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"oneOf.1.spendCeilingUsd.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.spendCeilingUsd","typeLabel":"number | null"},"model":{"type":"string","minLength":1,"maxLength":120,"uniqueKey":"oneOf.1.model","typeLabel":"string"},"imageAnnotationTemplateId":{"oneOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"oneOf.1.imageAnnotationTemplateId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","uniqueKey":"oneOf.1.imageAnnotationTemplateId.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.imageAnnotationTemplateId","typeLabel":"string\u003cuuid> | null"},"imageAnnotationGalleryTemplateId":{"oneOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"oneOf.1.imageAnnotationGalleryTemplateId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","uniqueKey":"oneOf.1.imageAnnotationGalleryTemplateId.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.imageAnnotationGalleryTemplateId","typeLabel":"string\u003cuuid> | null"},"imageAnnotationScope":{"type":"string","enum":["primary","all_gallery"],"uniqueKey":"oneOf.1.imageAnnotationScope","typeLabel":"enum\u003cstring>"},"workflow":{"type":"object","properties":{"enableRichDescription":{"type":"boolean","uniqueKey":"oneOf.1.workflow.enableRichDescription","typeLabel":"boolean"},"sourceImagesAutomatically":{"type":"boolean","uniqueKey":"oneOf.1.workflow.sourceImagesAutomatically","typeLabel":"boolean"},"autoAssignMarketplaceTaxonomy":{"type":"boolean","uniqueKey":"oneOf.1.workflow.autoAssignMarketplaceTaxonomy","typeLabel":"boolean"},"enableBackgroundRemoval":{"type":"boolean","uniqueKey":"oneOf.1.workflow.enableBackgroundRemoval","typeLabel":"boolean"},"enableMannequinRemoval":{"type":"boolean","uniqueKey":"oneOf.1.workflow.enableMannequinRemoval","typeLabel":"boolean"},"skipImageTagging":{"type":"boolean","uniqueKey":"oneOf.1.workflow.skipImageTagging","typeLabel":"boolean"},"skipZeroInventoryProducts":{"type":"boolean","uniqueKey":"oneOf.1.workflow.skipZeroInventoryProducts","typeLabel":"boolean"},"excludedImageTags":{"oneOf":[{"type":"string","maxLength":2000,"uniqueKey":"oneOf.1.workflow.excludedImageTags.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","minLength":1,"maxLength":120,"uniqueKey":"oneOf.1.workflow.excludedImageTags.oneOf.1.items.[INDEX]","typeLabel":"string"},"maxItems":50,"uniqueKey":"oneOf.1.workflow.excludedImageTags.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"oneOf.1.workflow.excludedImageTags","typeLabel":"string | string[]"},"enabledBuiltInImageTags":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":120,"uniqueKey":"oneOf.1.workflow.enabledBuiltInImageTags.items.[INDEX]","typeLabel":"string"},"uniqueKey":"oneOf.1.workflow.enabledBuiltInImageTags","typeLabel":"string[]"},"customImageTags":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120,"isRequired":true,"uniqueKey":"oneOf.1.workflow.customImageTags.items.[INDEX].name","typeLabel":"string"},"description":{"type":"string","minLength":1,"maxLength":280,"isRequired":true,"uniqueKey":"oneOf.1.workflow.customImageTags.items.[INDEX].description","typeLabel":"string"}},"required":["name","description"],"uniqueKey":"oneOf.1.workflow.customImageTags.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.1.workflow.customImageTags","typeLabel":"object[]"},"enrich":{"type":"boolean","uniqueKey":"oneOf.1.workflow.enrich","typeLabel":"boolean"},"disableAcoGeneration":{"description":"Accepted for compatibility. Bulk import does not queue ACO.","type":"boolean","uniqueKey":"oneOf.1.workflow.disableAcoGeneration","typeLabel":"boolean"},"skipEnrichment":{"type":"boolean","uniqueKey":"oneOf.1.workflow.skipEnrichment","typeLabel":"boolean"},"skipBackgroundRemoval":{"type":"boolean","uniqueKey":"oneOf.1.workflow.skipBackgroundRemoval","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"oneOf.1.workflow","typeLabel":"object"}},"uniqueKey":"oneOf.1","typeLabel":"object"},{"type":"object","required":["targetMarketplaces","marketplaceStoreSelections","documentId"],"properties":{"documentId":{"type":"string","minLength":1,"maxLength":255,"isRequired":true,"uniqueKey":"oneOf.2.documentId","typeLabel":"string"},"targetMarketplaces":{"minItems":1,"type":"array","items":{"type":"string","enum":["shopee","lazada","tiktok","shopify","whatsapp","zalora","amazon","ebay"],"uniqueKey":"oneOf.2.targetMarketplaces.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"oneOf.2.targetMarketplaces","typeLabel":"enum\u003cstring>[]"},"marketplaceStoreSelections":{"type":"object","minProperties":1,"description":"Required: select at least one connected store. One store per marketplace, not an array of store IDs.","properties":{"shopee":{"type":"string","description":"Connected shopee store ID.","uniqueKey":"oneOf.2.marketplaceStoreSelections.shopee","typeLabel":"string"},"lazada":{"type":"string","description":"Connected lazada store ID.","uniqueKey":"oneOf.2.marketplaceStoreSelections.lazada","typeLabel":"string"},"tiktok":{"type":"string","description":"Connected tiktok store ID.","uniqueKey":"oneOf.2.marketplaceStoreSelections.tiktok","typeLabel":"string"},"shopify":{"type":"string","description":"Connected shopify store ID.","uniqueKey":"oneOf.2.marketplaceStoreSelections.shopify","typeLabel":"string"},"whatsapp":{"type":"string","description":"Connected whatsapp store ID.","uniqueKey":"oneOf.2.marketplaceStoreSelections.whatsapp","typeLabel":"string"},"zalora":{"type":"string","description":"Connected zalora store ID.","uniqueKey":"oneOf.2.marketplaceStoreSelections.zalora","typeLabel":"string"},"amazon":{"type":"string","description":"Connected amazon store ID.","uniqueKey":"oneOf.2.marketplaceStoreSelections.amazon","typeLabel":"string"},"ebay":{"type":"string","description":"Connected ebay store ID.","uniqueKey":"oneOf.2.marketplaceStoreSelections.ebay","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.2.marketplaceStoreSelections","typeLabel":"object"},"title":{"oneOf":[{"type":"string","maxLength":120,"uniqueKey":"oneOf.2.title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"oneOf.2.title.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.2.title","typeLabel":"string | null"},"products":{"minItems":1,"maxItems":5000,"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","minLength":1,"maxLength":200,"isRequired":true,"uniqueKey":"oneOf.2.products.items.[INDEX].sku","typeLabel":"string"},"title":{"type":"string","maxLength":400,"uniqueKey":"oneOf.2.products.items.[INDEX].title","typeLabel":"string"},"gtin":{"type":"string","maxLength":100,"uniqueKey":"oneOf.2.products.items.[INDEX].gtin","typeLabel":"string"},"brand":{"type":"string","maxLength":160,"uniqueKey":"oneOf.2.products.items.[INDEX].brand","typeLabel":"string"},"description":{"type":"string","maxLength":10000,"uniqueKey":"oneOf.2.products.items.[INDEX].description","typeLabel":"string"},"price":{"type":"number","minimum":0,"uniqueKey":"oneOf.2.products.items.[INDEX].price","typeLabel":"number"},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$","uniqueKey":"oneOf.2.products.items.[INDEX].currency","typeLabel":"string"},"compareAtPrice":{"type":"number","minimum":0,"uniqueKey":"oneOf.2.products.items.[INDEX].compareAtPrice","typeLabel":"number"},"salePrice":{"type":"number","minimum":0,"uniqueKey":"oneOf.2.products.items.[INDEX].salePrice","typeLabel":"number"},"costPerItem":{"type":"number","minimum":0,"uniqueKey":"oneOf.2.products.items.[INDEX].costPerItem","typeLabel":"number"},"inventory":{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"oneOf.2.products.items.[INDEX].inventory","typeLabel":"integer"},"images":{"maxItems":30,"type":"array","items":{"type":"string","format":"uri","maxLength":2048,"uniqueKey":"oneOf.2.products.items.[INDEX].images.items.[INDEX]","typeLabel":"string\u003curi>"},"uniqueKey":"oneOf.2.products.items.[INDEX].images","typeLabel":"string\u003curi>[]"},"category":{"type":"string","maxLength":255,"uniqueKey":"oneOf.2.products.items.[INDEX].category","typeLabel":"string"},"categoryName":{"type":"string","maxLength":500,"uniqueKey":"oneOf.2.products.items.[INDEX].categoryName","typeLabel":"string"},"weight":{"type":"number","minimum":0,"uniqueKey":"oneOf.2.products.items.[INDEX].weight","typeLabel":"number"},"dimensions":{"type":"object","properties":{"length":{"type":"number","minimum":0,"isRequired":true,"uniqueKey":"oneOf.2.products.items.[INDEX].dimensions.length","typeLabel":"number"},"width":{"type":"number","minimum":0,"isRequired":true,"uniqueKey":"oneOf.2.products.items.[INDEX].dimensions.width","typeLabel":"number"},"height":{"type":"number","minimum":0,"isRequired":true,"uniqueKey":"oneOf.2.products.items.[INDEX].dimensions.height","typeLabel":"number"}},"required":["length","width","height"],"additionalProperties":false,"uniqueKey":"oneOf.2.products.items.[INDEX].dimensions","typeLabel":"object"}},"required":["sku"],"additionalProperties":false,"uniqueKey":"oneOf.2.products.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.2.products","typeLabel":"object[]"},"organizationId":{"type":"string","minLength":1,"maxLength":120,"uniqueKey":"oneOf.2.organizationId","typeLabel":"string"},"csvText":{"type":"string","uniqueKey":"oneOf.2.csvText","typeLabel":"string"},"fileName":{"type":"string","maxLength":500,"uniqueKey":"oneOf.2.fileName","typeLabel":"string"},"selectedRowIndexes":{"type":"array","items":{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"oneOf.2.selectedRowIndexes.items.[INDEX]","typeLabel":"integer"},"uniqueKey":"oneOf.2.selectedRowIndexes","typeLabel":"integer[]"},"lane":{"type":"string","enum":["standard","enterprise"],"uniqueKey":"oneOf.2.lane","typeLabel":"enum\u003cstring>"},"targetCountries":{"type":"array","items":{"type":"string","minLength":1,"maxLength":80,"uniqueKey":"oneOf.2.targetCountries.items.[INDEX]","typeLabel":"string"},"uniqueKey":"oneOf.2.targetCountries","typeLabel":"string[]"},"fieldMapping":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"oneOf.2.fieldMapping.additionalProperties","typeLabel":"string"},"uniqueKey":"oneOf.2.fieldMapping","typeLabel":"object"},"dedupPolicy":{"type":"string","enum":["keep_first","keep_last","merge_fields_prefer_non_empty","fail_job"],"uniqueKey":"oneOf.2.dedupPolicy","typeLabel":"enum\u003cstring>"},"autoApproveThreshold":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"oneOf.2.autoApproveThreshold.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"oneOf.2.autoApproveThreshold.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.2.autoApproveThreshold","typeLabel":"number | null"},"spendCeilingUsd":{"oneOf":[{"type":"number","minimum":0,"uniqueKey":"oneOf.2.spendCeilingUsd.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"oneOf.2.spendCeilingUsd.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.2.spendCeilingUsd","typeLabel":"number | null"},"model":{"type":"string","minLength":1,"maxLength":120,"uniqueKey":"oneOf.2.model","typeLabel":"string"},"imageAnnotationTemplateId":{"oneOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"oneOf.2.imageAnnotationTemplateId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","uniqueKey":"oneOf.2.imageAnnotationTemplateId.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.2.imageAnnotationTemplateId","typeLabel":"string\u003cuuid> | null"},"imageAnnotationGalleryTemplateId":{"oneOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"oneOf.2.imageAnnotationGalleryTemplateId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","uniqueKey":"oneOf.2.imageAnnotationGalleryTemplateId.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.2.imageAnnotationGalleryTemplateId","typeLabel":"string\u003cuuid> | null"},"imageAnnotationScope":{"type":"string","enum":["primary","all_gallery"],"uniqueKey":"oneOf.2.imageAnnotationScope","typeLabel":"enum\u003cstring>"},"workflow":{"type":"object","properties":{"enableRichDescription":{"type":"boolean","uniqueKey":"oneOf.2.workflow.enableRichDescription","typeLabel":"boolean"},"sourceImagesAutomatically":{"type":"boolean","uniqueKey":"oneOf.2.workflow.sourceImagesAutomatically","typeLabel":"boolean"},"autoAssignMarketplaceTaxonomy":{"type":"boolean","uniqueKey":"oneOf.2.workflow.autoAssignMarketplaceTaxonomy","typeLabel":"boolean"},"enableBackgroundRemoval":{"type":"boolean","uniqueKey":"oneOf.2.workflow.enableBackgroundRemoval","typeLabel":"boolean"},"enableMannequinRemoval":{"type":"boolean","uniqueKey":"oneOf.2.workflow.enableMannequinRemoval","typeLabel":"boolean"},"skipImageTagging":{"type":"boolean","uniqueKey":"oneOf.2.workflow.skipImageTagging","typeLabel":"boolean"},"skipZeroInventoryProducts":{"type":"boolean","uniqueKey":"oneOf.2.workflow.skipZeroInventoryProducts","typeLabel":"boolean"},"excludedImageTags":{"oneOf":[{"type":"string","maxLength":2000,"uniqueKey":"oneOf.2.workflow.excludedImageTags.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","minLength":1,"maxLength":120,"uniqueKey":"oneOf.2.workflow.excludedImageTags.oneOf.1.items.[INDEX]","typeLabel":"string"},"maxItems":50,"uniqueKey":"oneOf.2.workflow.excludedImageTags.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"oneOf.2.workflow.excludedImageTags","typeLabel":"string | string[]"},"enabledBuiltInImageTags":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":120,"uniqueKey":"oneOf.2.workflow.enabledBuiltInImageTags.items.[INDEX]","typeLabel":"string"},"uniqueKey":"oneOf.2.workflow.enabledBuiltInImageTags","typeLabel":"string[]"},"customImageTags":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120,"isRequired":true,"uniqueKey":"oneOf.2.workflow.customImageTags.items.[INDEX].name","typeLabel":"string"},"description":{"type":"string","minLength":1,"maxLength":280,"isRequired":true,"uniqueKey":"oneOf.2.workflow.customImageTags.items.[INDEX].description","typeLabel":"string"}},"required":["name","description"],"uniqueKey":"oneOf.2.workflow.customImageTags.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.2.workflow.customImageTags","typeLabel":"object[]"},"enrich":{"type":"boolean","uniqueKey":"oneOf.2.workflow.enrich","typeLabel":"boolean"},"disableAcoGeneration":{"description":"Accepted for compatibility. Bulk import does not queue ACO.","type":"boolean","uniqueKey":"oneOf.2.workflow.disableAcoGeneration","typeLabel":"boolean"},"skipEnrichment":{"type":"boolean","uniqueKey":"oneOf.2.workflow.skipEnrichment","typeLabel":"boolean"},"skipBackgroundRemoval":{"type":"boolean","uniqueKey":"oneOf.2.workflow.skipBackgroundRemoval","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"oneOf.2.workflow","typeLabel":"object"}},"uniqueKey":"oneOf.2","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"example":{"products":[{"sku":"SKU-1","title":"Sample product","price":19.9,"costPerItem":10,"inventory":20,"images":["https://cdn.example.com/sku-1.jpg"]}],"targetMarketplaces":["shopee"],"marketplaceStoreSelections":{"shopee":"store_123"},"workflow":{"enableRichDescription":true,"autoAssignMarketplaceTaxonomy":true}},"examples":{"Example":{"title":"Example","value":{"products":[{"sku":"SKU-1","title":"Sample product","price":19.9,"costPerItem":10,"inventory":20,"images":["https://cdn.example.com/sku-1.jpg"]}],"targetMarketplaces":["shopee"],"marketplaceStoreSelections":{"shopee":"store_123"},"workflow":{"enableRichDescription":true,"autoAssignMarketplaceTaxonomy":true}}}},"exampleType":"examples"},"multipart/form-data":{"schema":{"type":"object","required":["file","targetMarketplaces","marketplaceStoreSelections"],"properties":{"file":{"type":"string","format":"binary","description":"CSV file or JSON array containing product rows. JSON object files may wrap the array as `products`.","isRequired":true,"uniqueKey":"file","typeLabel":"file"},"targetMarketplaces":{"oneOf":[{"type":"string","description":"Comma-separated marketplace list, e.g. `shopee,lazada`.","isRequired":true,"uniqueKey":"targetMarketplaces.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","enum":["shopee","lazada","tiktok","shopify","whatsapp","zalora","amazon","ebay"],"uniqueKey":"targetMarketplaces.oneOf.1.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"targetMarketplaces.oneOf.1","typeLabel":"enum\u003cstring>[]"}],"isRequired":true,"uniqueKey":"targetMarketplaces","typeLabel":"string | enum\u003cstring>[]"},"marketplaceStoreSelections":{"oneOf":[{"type":"object","description":"Connected store ID for each target marketplace. JSON requests send an object; multipart may send that object as a JSON string.","minProperties":1,"properties":{"shopee":{"type":"string","description":"Connected shopee store ID.","uniqueKey":"marketplaceStoreSelections.oneOf.0.shopee","typeLabel":"string"},"lazada":{"type":"string","description":"Connected lazada store ID.","uniqueKey":"marketplaceStoreSelections.oneOf.0.lazada","typeLabel":"string"},"tiktok":{"type":"string","description":"Connected tiktok store ID.","uniqueKey":"marketplaceStoreSelections.oneOf.0.tiktok","typeLabel":"string"},"shopify":{"type":"string","description":"Connected shopify store ID.","uniqueKey":"marketplaceStoreSelections.oneOf.0.shopify","typeLabel":"string"},"whatsapp":{"type":"string","description":"Connected whatsapp store ID.","uniqueKey":"marketplaceStoreSelections.oneOf.0.whatsapp","typeLabel":"string"},"zalora":{"type":"string","description":"Connected zalora store ID.","uniqueKey":"marketplaceStoreSelections.oneOf.0.zalora","typeLabel":"string"},"amazon":{"type":"string","description":"Connected amazon store ID.","uniqueKey":"marketplaceStoreSelections.oneOf.0.amazon","typeLabel":"string"},"ebay":{"type":"string","description":"Connected ebay store ID.","uniqueKey":"marketplaceStoreSelections.oneOf.0.ebay","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"marketplaceStoreSelections.oneOf.0","typeLabel":"object"},{"type":"string","description":"Connected store ID for each target marketplace. JSON requests send an object; multipart may send that object as a JSON string.","isRequired":true,"uniqueKey":"marketplaceStoreSelections.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"marketplaceStoreSelections","typeLabel":"object | string"},"organizationId":{"type":"string","description":"Optional for API-key requests; required for session-authenticated requests across multiple organizations.","uniqueKey":"organizationId","typeLabel":"string"},"fileName":{"type":"string","description":"Optional display name override. Defaults to the uploaded file name.","uniqueKey":"fileName","typeLabel":"string"},"title":{"type":"string","maxLength":120,"description":"Optional name for the generated Review job.","uniqueKey":"title","typeLabel":"string"},"targetCountries":{"oneOf":[{"type":"string","description":"Ignored. Catalog country comes from marketplaceStoreSelections.","uniqueKey":"targetCountries.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"targetCountries.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"targetCountries.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"targetCountries","typeLabel":"string | string[]"},"fieldMapping":{"type":"string","description":"JSON object mapping CSV headers to import fields, e.g. `{\"sku\":\"SKU\",\"title\":\"Product Name\"}`.","uniqueKey":"fieldMapping","typeLabel":"string"},"selectedRowIndexes":{"type":"string","description":"JSON array of zero-based CSV row indexes to import.","uniqueKey":"selectedRowIndexes","typeLabel":"string"},"lane":{"type":"string","enum":["standard","enterprise"],"uniqueKey":"lane","typeLabel":"enum\u003cstring>"},"dedupPolicy":{"type":"string","enum":["keep_first","keep_last","merge_fields_prefer_non_empty","fail_job"],"uniqueKey":"dedupPolicy","typeLabel":"enum\u003cstring>"},"autoApproveThreshold":{"oneOf":[{"type":"number","description":"Optional confidence threshold between 0 and 1, or the string `null`.","uniqueKey":"autoApproveThreshold.oneOf.0","typeLabel":"number"},{"type":"string","description":"Optional confidence threshold between 0 and 1, or the string `null`.","uniqueKey":"autoApproveThreshold.oneOf.1","typeLabel":"string"}],"uniqueKey":"autoApproveThreshold","typeLabel":"number | string"},"spendCeilingUsd":{"oneOf":[{"type":"number","uniqueKey":"spendCeilingUsd.oneOf.0","typeLabel":"number"},{"type":"string","uniqueKey":"spendCeilingUsd.oneOf.1","typeLabel":"string"}],"uniqueKey":"spendCeilingUsd","typeLabel":"number | string"},"model":{"type":"string","description":"Optional enrichment model override.","uniqueKey":"model","typeLabel":"string"},"imageAnnotationTemplateId":{"type":"string","format":"uuid","uniqueKey":"imageAnnotationTemplateId","typeLabel":"string\u003cuuid>"},"imageAnnotationGalleryTemplateId":{"type":"string","format":"uuid","uniqueKey":"imageAnnotationGalleryTemplateId","typeLabel":"string\u003cuuid>"},"imageAnnotationScope":{"type":"string","enum":["primary","all_gallery"],"uniqueKey":"imageAnnotationScope","typeLabel":"enum\u003cstring>"},"workflow":{"type":"string","description":"JSON object with enrichment workflow options such as `sourceImagesAutomatically`, `enableRichDescription`, and `autoAssignMarketplaceTaxonomy`.","uniqueKey":"workflow","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"file":"\u003cstring>","targetMarketplaces":"\u003cstring>","marketplaceStoreSelections":{"shopee":"\u003cstring>","lazada":"\u003cstring>","tiktok":"\u003cstring>","shopify":"\u003cstring>","whatsapp":"\u003cstring>","zalora":"\u003cstring>","amazon":"\u003cstring>","ebay":"\u003cstring>"},"organizationId":"\u003cstring>","fileName":"\u003cstring>","title":"\u003cstring>","targetCountries":"\u003cstring>","fieldMapping":"\u003cstring>","selectedRowIndexes":"\u003cstring>","autoApproveThreshold":123,"spendCeilingUsd":123,"model":"\u003cstring>","imageAnnotationTemplateId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","imageAnnotationGalleryTemplateId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","workflow":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"examples"},"responses":{"31fad7ba-7c82-40ee-932e-8ca0789ef786":{"description":"Bulk import workflow accepted","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","uniqueKey":"ok","typeLabel":"boolean"},"apiVersion":{"type":"string","default":"developer_v1","uniqueKey":"apiVersion","typeLabel":"string"},"operationId":{"type":"string","uniqueKey":"operationId","typeLabel":"string"},"status":{"type":"string","uniqueKey":"status","typeLabel":"string"},"jobId":{"type":"string","description":"Bulk import job ID with `bulk_` prefix.","uniqueKey":"jobId","typeLabel":"string"},"warnings":{"type":"array","items":{"type":"string","uniqueKey":"warnings.items.[INDEX]","typeLabel":"string"},"uniqueKey":"warnings","typeLabel":"string[]"},"recommendations":{"type":"array","items":{"type":"string","uniqueKey":"recommendations.items.[INDEX]","typeLabel":"string"},"uniqueKey":"recommendations","typeLabel":"string[]"},"links":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"links.additionalProperties","typeLabel":"string"},"uniqueKey":"links","typeLabel":"object"},"data":{"type":"object","properties":{"rowCount":{"type":"integer","uniqueKey":"data.rowCount","typeLabel":"integer"},"fileName":{"type":"string","uniqueKey":"data.fileName","typeLabel":"string"},"targetMarketplaces":{"type":"array","items":{"type":"string","uniqueKey":"data.targetMarketplaces.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.targetMarketplaces","typeLabel":"string[]"},"targetCountries":{"type":"array","items":{"type":"string","uniqueKey":"data.targetCountries.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.targetCountries","typeLabel":"string[]"},"fieldMapping":{"type":"object","uniqueKey":"data.fieldMapping","typeLabel":"object"},"counts":{"type":"object","uniqueKey":"data.counts","typeLabel":"object"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":true,"apiVersion":"developer_v1","operationId":"\u003cstring>","status":"\u003cstring>","jobId":"\u003cstring>","warnings":["\u003cstring>"],"recommendations":["\u003cstring>"],"links":{},"data":{"rowCount":123,"fileName":"\u003cstring>","targetMarketplaces":["\u003cstring>"],"targetCountries":["\u003cstring>"],"fieldMapping":{},"counts":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"3219ce14-7cde-44b4-b843-1ab3edf80e00":{"description":"Bad Request - Invalid products, CSV, or payload","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"a7c5447f-1683-4c35-9849-9a8689095e98":{"description":"Unauthorized - Invalid or missing Bearer token","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"49156310-d583-42c0-afc6-6d2e9477677d":{"description":"Forbidden - Token not authorized for this organization","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"7cc24dd4-d4ff-4213-8349-58c0589df8f2":{"description":"Payload Too Large - JSON request or file upload exceeds limit","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"fdf09805-f6e5-4ea0-9a12-609eb442937b":{"description":"Internal Server Error","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"1707e6c5-4fad-4b1f-a950-9e63965eeed5":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"Bearer API key for server-to-server access. Session auth is also supported in first-party UI flows.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"39970a03-ff72-4559-a542-364a55d2e30f":{"url":"https://omnicommerce.sg","description":"Production"},"1047c457-3777-4869-be4f-4e086fafbbca":{"url":"http://localhost:3000","description":"Local development"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"Bearer API key for server-to-server access. Session auth is also supported in first-party UI flows.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer API key for server-to-server access. Session auth is also supported in first-party UI flows.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"omnicommerce","siteName":"OmniCommerce","title":"Bulk Import Products from JSON or CSV - OmniCommerce","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-23T07:13:58.039Z","originalFileLocation":"api-reference/products/bulk-import-products-from-json-or-csv.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=\"dark\"}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=\"Queue a bulk product import for the authenticated organization. ### Input options - Upload a CSV (2 MiB) or JSON products file (8 MiB) using multipart/form-data. - Send JSON with a products array of 1–5,000 flat product objects (8 MiB request maximum). - Send JSON with inline csvText. - Send JSON referencing a stored documentId. ### Asynchronous result The API creates import rows, then queues draft creation and AI Review through Inngest. Completed import jobs expose reviewBatchIds, reviewUrls, and reviewWarnings; generated changes require Review approval. Poll the returned bulk_... job with GET /api/v1/jobs/{jobId}. Cancel an in-flight import with POST /api/v1/jobs/{jobId}/cancel.\">\u003cmeta data-mint-head name=\"application-name\" content=\"OmniCommerce\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/omnicommerce/20sPCJ3GohzNbY_P/_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=\"/mintlify-assets/_mintlify/favicons/omnicommerce/20sPCJ3GohzNbY_P/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/omnicommerce/20sPCJ3GohzNbY_P/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/omnicommerce/20sPCJ3GohzNbY_P/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/omnicommerce/20sPCJ3GohzNbY_P/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/omnicommerce/20sPCJ3GohzNbY_P/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/omnicommerce/20sPCJ3GohzNbY_P/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/omnicommerce/20sPCJ3GohzNbY_P/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/omnicommerce/20sPCJ3GohzNbY_P/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Bulk Import Products from JSON or CSV - OmniCommerce\">\u003cmeta data-mint-head property=\"og:description\" content=\"Queue a bulk product import for the authenticated organization. ### Input options - Upload a CSV (2 MiB) or JSON products file (8 MiB) using multipart/form-data. - Send JSON with a products array of 1–5,000 flat product objects (8 MiB request maximum). - Send JSON with inline csvText. - Send JSON referencing a stored documentId. ### Asynchronous result The API creates import rows, then queues draft creation and AI Review through Inngest. Completed import jobs expose reviewBatchIds, reviewUrls, and reviewWarnings; generated changes require Review approval. Poll the returned bulk_... job with GET /api/v1/jobs/{jobId}. Cancel an in-flight import with POST /api/v1/jobs/{jobId}/cancel.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OmniCommerce Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.omnicommerce.sg/api-reference/products/bulk-import-products-from-json-or-csv\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://omnicommerce.mintlify.app/_mintlify/api/og/v2?division=Products\u0026amp;title=Bulk+Import+Products+from+JSON+or+CSV\u0026amp;description=Queue+a+bulk+product+import+for+the+authenticated+organization.%0A%0A%23%23%23+Input+options%0A%0A-+Upload+a+CSV+%282+MiB%29+or+JSON+products+file+%288+MiB%29+using+%60multipart%2Fform-d\u0026amp;theme=1a59a306fe3109e355163fa6\u0026amp;signature=810f1681aa894058e43c6c922094e9bb1fcb760d7c2c8a39be56833efb4f48ab\">\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=\"Bulk Import Products from JSON or CSV - OmniCommerce\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Queue a bulk product import for the authenticated organization. ### Input options - Upload a CSV (2 MiB) or JSON products file (8 MiB) using multipart/form-data. - Send JSON with a products array of 1–5,000 flat product objects (8 MiB request maximum). - Send JSON with inline csvText. - Send JSON referencing a stored documentId. ### Asynchronous result The API creates import rows, then queues draft creation and AI Review through Inngest. Completed import jobs expose reviewBatchIds, reviewUrls, and reviewWarnings; generated changes require Review approval. Poll the returned bulk_... job with GET /api/v1/jobs/{jobId}. Cancel an in-flight import with POST /api/v1/jobs/{jobId}/cancel.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://omnicommerce.mintlify.app/_mintlify/api/og/v2?division=Products\u0026amp;title=Bulk+Import+Products+from+JSON+or+CSV\u0026amp;description=Queue+a+bulk+product+import+for+the+authenticated+organization.%0A%0A%23%23%23+Input+options%0A%0A-+Upload+a+CSV+%282+MiB%29+or+JSON+products+file+%288+MiB%29+using+%60multipart%2Fform-d\u0026amp;theme=1a59a306fe3109e355163fa6\u0026amp;signature=810f1681aa894058e43c6c922094e9bb1fcb760d7c2c8a39be56833efb4f48ab\">\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=\"/mintlify-assets/_mintlify/favicons/omnicommerce/20sPCJ3GohzNbY_P/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OmniCommerce\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0F766E\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.omnicommerce.sg/api-reference/products/bulk-import-products-from-json-or-csv\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/products/bulk-import-products-from-json-or-csv.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.omnicommerce.sg/#organization\",\"name\":\"OmniCommerce\",\"url\":\"https://docs.omnicommerce.sg\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/omnicommerce/B2cjFTJ7Zt2npdeV/logo/light.svg?fit=max\u0026auto=format\u0026n=B2cjFTJ7Zt2npdeV\u0026q=85\u0026s=e012509da06089923275e6b0415addf9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.omnicommerce.sg#website\",\"name\":\"OmniCommerce\",\"url\":\"https://docs.omnicommerce.sg\",\"publisher\":{\"@id\":\"https://docs.omnicommerce.sg/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.omnicommerce.sg/api-reference/products/bulk-import-products-from-json-or-csv#webpage\",\"url\":\"https://docs.omnicommerce.sg/api-reference/products/bulk-import-products-from-json-or-csv\",\"name\":\"Bulk Import Products from JSON or CSV\",\"description\":\"Queue a bulk product import for the authenticated organization. ### Input options - Upload a CSV (2 MiB) or JSON products file (8 MiB) using multipart/form-data. - Send JSON with a products array of 1–5,000 flat product objects (8 MiB request maximum). - Send JSON with inline csvText. - Send JSON referencing a stored documentId. ### Asynchronous result The API creates import rows, then queues draft creation and AI Review through Inngest. Completed import jobs expose reviewBatchIds, reviewUrls, and reviewWarnings; generated changes require Review approval. Poll the returned bulk_... job with GET /api/v1/jobs/{jobId}. Cancel an in-flight import with POST /api/v1/jobs/{jobId}/cancel.\",\"dateModified\":\"2026-10-23T07:13:58.039Z\",\"isPartOf\":{\"@id\":\"https://docs.omnicommerce.sg#website\"},\"breadcrumb\":{\"@id\":\"https://docs.omnicommerce.sg/api-reference/products/bulk-import-products-from-json-or-csv#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.omnicommerce.sg/api-reference/products/bulk-import-products-from-json-or-csv#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.omnicommerce.sg/api-reference/agents/invoke-the-omni-agent\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Products\",\"item\":\"https://docs.omnicommerce.sg/api-reference/products/export-catalog-items\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Bulk Import Products from JSON or CSV\",\"item\":\"https://docs.omnicommerce.sg/api-reference/products/bulk-import-products-from-json-or-csv\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.omnicommerce.sg/api-reference/products/bulk-import-products-from-json-or-csv#apireference\",\"headline\":\"Bulk Import Products from JSON or CSV\",\"name\":\"Bulk Import Products from JSON or CSV\",\"description\":\"Queue a bulk product import for the authenticated organization. ### Input options - Upload a CSV (2 MiB) or JSON products file (8 MiB) using multipart/form-data. - Send JSON with a products array of 1–5,000 flat product objects (8 MiB request maximum). - Send JSON with inline csvText. - Send JSON referencing a stored documentId. ### Asynchronous result The API creates import rows, then queues draft creation and AI Review through Inngest. Completed import jobs expose reviewBatchIds, reviewUrls, and reviewWarnings; generated changes require Review approval. Poll the returned bulk_... job with GET /api/v1/jobs/{jobId}. Cancel an in-flight import with POST /api/v1/jobs/{jobId}/cancel.\",\"url\":\"https://docs.omnicommerce.sg/api-reference/products/bulk-import-products-from-json-or-csv\",\"mainEntityOfPage\":{\"@id\":\"https://docs.omnicommerce.sg/api-reference/products/bulk-import-products-from-json-or-csv#webpage\"},\"dateModified\":\"2026-10-23T07:13:58.039Z\",\"publisher\":{\"@id\":\"https://docs.omnicommerce.sg/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.omnicommerce.sg#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OmniCommerce\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"OmniCommerce","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Reference","href":"/api-reference"}]},{"group":"Endpoints","pages":[{"group":"Agents","pages":[{"title":"Invoke the Omni agent","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/agents/general/invoke","href":"/api-reference/agents/invoke-the-omni-agent"},{"title":"Start an Omni agent run","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/agents/general/runs","href":"/api-reference/agents/start-an-omni-agent-run"},{"title":"Get an Omni agent run","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/agents/general/runs/{runId}","href":"/api-reference/agents/get-an-omni-agent-run"}]},{"group":"Analytics","pages":[{"title":"Get Ads Analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/analytics/ads","href":"/api-reference/analytics/get-ads-analytics"},{"title":"Get AI Traffic Analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/analytics/ai-traffic","href":"/api-reference/analytics/get-ai-traffic-analytics"},{"title":"Get Video and LIVE Analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/analytics/content","href":"/api-reference/analytics/get-video-and-live-analytics"},{"title":"Get Order Analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/analytics/orders","href":"/api-reference/analytics/get-order-analytics"},{"title":"Get Growth Overview","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/analytics/overview","href":"/api-reference/analytics/get-growth-overview"},{"title":"Get Pricing Analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/analytics/pricing","href":"/api-reference/analytics/get-pricing-analytics"},{"title":"Get Product Analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/analytics/products","href":"/api-reference/analytics/get-product-analytics"},{"title":"Get Profit Analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/analytics/profit","href":"/api-reference/analytics/get-profit-analytics"},{"title":"Get Business Report","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/analytics/reports","href":"/api-reference/analytics/get-business-report"},{"title":"Get Store Analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/analytics/stores","href":"/api-reference/analytics/get-store-analytics"},{"title":"Get Traffic Analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/analytics/traffic","href":"/api-reference/analytics/get-traffic-analytics"}]},{"group":"AOPs","pages":[{"title":"Get AOP configuration","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/aop/{aopId}/config","href":"/api-reference/aops/get-aop-configuration"},{"title":"Overwrite AOP configuration","deprecated":null,"version":null,"openapi":"/openapi.json put /api/v1/aop/{aopId}/config","href":"/api-reference/aops/overwrite-aop-configuration"},{"title":"Execute an AOP","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/aop/{aopId}/execute","href":"/api-reference/aops/execute-an-aop"},{"title":"Create AOP","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/aop/create","href":"/api-reference/aops/create-aop"},{"title":"Retry a failed AOP execution","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/aop/retry","href":"/api-reference/aops/retry-a-failed-aop-execution"},{"title":"Get Thread Status","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/threads/{thread_id}/status","href":"/api-reference/aops/get-thread-status"}]},{"group":"Developer Platform","pages":[{"title":"Import BrandsGateway Products","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/brandsgateway/import","href":"/api-reference/developer-platform/import-brandsgateway-products"},{"title":"Evaluate SKU Readiness","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/evaluate","href":"/api-reference/developer-platform/evaluate-sku-readiness"},{"title":"Generate Ghost Mannequin Image","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/images/ghost-mannequin","href":"/api-reference/developer-platform/generate-ghost-mannequin-image"},{"title":"Get Developer Job Status","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/jobs/{jobId}","href":"/api-reference/developer-platform/get-developer-job-status"},{"title":"Cancel Developer Job","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/jobs/{jobId}/cancel","href":"/api-reference/developer-platform/cancel-developer-job"},{"title":"Recommend Marketplace Product Categories","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/manage-product-category/recommend","href":"/api-reference/developer-platform/recommend-marketplace-product-categories"},{"title":"List Connected Marketplaces","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/marketplaces/connected","href":"/api-reference/developer-platform/list-connected-marketplaces"},{"title":"Run AI Shelf Share Monitor","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/monitor","href":"/api-reference/developer-platform/run-ai-shelf-share-monitor"},{"title":"Sync Product Commercial Fields","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/sync","href":"/api-reference/developer-platform/sync-product-commercial-fields"},{"title":"List Webhook Events","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/webhook-events","href":"/api-reference/developer-platform/list-webhook-events"},{"title":"List Developer Webhooks","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/webhooks","href":"/api-reference/developer-platform/list-developer-webhooks"},{"title":"Create Developer Webhook","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/webhooks","href":"/api-reference/developer-platform/create-developer-webhook"},{"title":"Get Selected Zalora Import Status","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/zalora/import","href":"/api-reference/developer-platform/get-selected-zalora-import-status"},{"title":"Import Selected Zalora Products","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/zalora/import","href":"/api-reference/developer-platform/import-selected-zalora-products"}]},{"group":"Campaigns","pages":[{"title":"List Campaigns","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/campaigns","href":"/api-reference/campaigns/list-campaigns"},{"title":"Create Campaign","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/campaigns","href":"/api-reference/campaigns/create-campaign"},{"title":"Get Campaign","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/campaigns/{campaignId}","href":"/api-reference/campaigns/get-campaign"},{"title":"Update Campaign","deprecated":null,"version":null,"openapi":"/openapi.json put /api/v1/campaigns/{campaignId}","href":"/api-reference/campaigns/update-campaign"},{"title":"Act on Campaign","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/campaigns/{campaignId}/actions","href":"/api-reference/campaigns/act-on-campaign"},{"title":"Archive Campaigns","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/campaigns/archive","href":"/api-reference/campaigns/archive-campaigns"},{"title":"Delete Campaigns","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/campaigns/delete","href":"/api-reference/campaigns/delete-campaigns"},{"title":"Get Campaign Options","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/campaigns/options","href":"/api-reference/campaigns/get-campaign-options"}]},{"group":"Products","pages":[{"title":"Export Catalog Items","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/catalog/items","href":"/api-reference/products/export-catalog-items"},{"title":"List Products","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/products","href":"/api-reference/products/list-products"},{"title":"Create Product","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/products","href":"/api-reference/products/create-product"},{"title":"Get Product","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/products/{productId}","href":"/api-reference/products/get-product"},{"title":"Delete Product","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/products/{productId}","href":"/api-reference/products/delete-product"},{"title":"Update Product","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/products/{productId}","href":"/api-reference/products/update-product"},{"title":"Update Product Cost","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/products/{productId}/cost","href":"/api-reference/products/update-product-cost"},{"title":"Delist Product","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/products/{productId}/delist","href":"/api-reference/products/delist-product"},{"title":"Upload Product Image","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/products/{productId}/images","href":"/api-reference/products/upload-product-image"},{"title":"Update Product Inventory","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/products/{productId}/inventory","href":"/api-reference/products/update-product-inventory"},{"title":"Get Product Listings","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/products/{productId}/listings","href":"/api-reference/products/get-product-listings"},{"title":"Update Product Price","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/products/{productId}/price","href":"/api-reference/products/update-product-price"},{"title":"Publish Product","description":"### Publishing\n\nQueue durable marketplace publish/update jobs for a product. Omit marketplaces to use every enabled or already listed marketplace, or name the marketplaces to target. Omit updateFields for a full publish with live/draft visibility. Set updateFields to update only saved values for those fields on existing listings with assigned stores; other fields and listing visibility stay unchanged. No new listing is created by a selected-field update.\n\n### Marketplace capabilities\n\nSEO is Shopify-only; highlights support Lazada, TikTok and Amazon; attributes exclude WhatsApp. Category-only updates require a full publish on TikTok and Amazon. Unsupported combinations and missing listings/stores return explicit per-marketplace failures while valid targets continue.\n\n### Completion\n\nAccepted means queued; inspect every result and await every jobId and inventory correlation with jobs.wait, then verify the listings.","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/products/{productId}/publish","href":"/api-reference/products/publish-product"},{"title":"Bulk Import Products from JSON or CSV","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/products/bulk-import","href":"/api-reference/products/bulk-import-products-from-json-or-csv"},{"title":"Compare Product Market Prices","description":"Research market offers for a batch of OmniCommerce simple product or variant UUIDs using the same BigGo API and Serper Shopping fallback as pricing strategy. Read-only; no prices are changed.\n\n### Authorization\n\nRequires catalog:read. API keys resolve organizationId from the credential; session callers must provide an authorized organizationId.\n\n### Durable batches\n\nAccepts 1–50 input entries, trimmed and deduplicated in first-requested order. Returns HTTP 202 and a durable jobId. Retrieve progress and results from GET /api/v1/products/compare-prices/jobs/{jobId} or await jobs.wait in the SDK with a suitable timeout. A client timeout does not cancel the job. Use variant IDs for products with variants. Each listing market has its own durable search step; searches use bounded concurrency and retry failed providers once. Final result.success is true only when every requested product and listing market succeeds. Partial failures remain explicit.\n\nOmit country/gl to compare every recorded listing market. Global Zalora compares its exact country prices in SG, MY, ID, PH, HK, and TW as present on the listing; variant offers use exact SKU/variant identity. An India Shopify store selling in SGD is researched in Singapore because market selection follows selling currency, not the store address. gl overrides country and restricts research to that market. Unsupported currencies and missing country prices are reported without silently skipping listings or converting currencies.\n\nresults[].markets contains separate platform/store/country prices and shopping statistics. Prices come from persisted marketplace snapshots or acknowledged marketplace writes; priceSource and priceAsOf identify the evidence. Published listings without exact price evidence may return catalog research but success is false, with an explicit verification error. Unlisted products use their catalog price/currency. Research does not refresh the connected marketplace listing; refresh stale listing data before comparing.\n\nMarket comparison measures recorded listing list price minus market median (p50), with percentage relative to the median. Catalog fallback comparisons use the explicitly named catalog_price_vs_market_median metric. The product-level currentPrice/currency remain catalog fields; product-level research/comparison are available only for a single market with compatible currency. For multiple markets, consume markets[]. These differences are not recommended selling prices; monetary values are never combined across currencies.\n\nShopping search coverage depends on the provider index; individual marketplaces and listings are not verified.\n\nOffers may refer to different variants, pack sizes, bundles, or similar products. Verify the offer before using its price.\n\nPricing strategy excludes offers from ebay and walmart.","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/products/compare-prices","href":"/api-reference/products/compare-product-market-prices"},{"title":"Get Product Price Comparison","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/products/compare-prices/jobs/{jobId}","href":"/api-reference/products/get-product-price-comparison"},{"title":"Batch Update Product Cost","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/products/cost","href":"/api-reference/products/batch-update-product-cost"},{"title":"Queue Product Enrichment","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/products/enrich","href":"/api-reference/products/queue-product-enrichment"}]},{"group":"Agentic Checkout","pages":[{"title":"Create Agentic Checkout Session","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/checkout-sessions","href":"/api-reference/agentic-checkout/create-agentic-checkout-session"},{"title":"Get Agentic Checkout Session","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/checkout-sessions/{sessionId}","href":"/api-reference/agentic-checkout/get-agentic-checkout-session"},{"title":"Replace Agentic Checkout Session Fields","deprecated":null,"version":null,"openapi":"/openapi.json put /api/v1/checkout-sessions/{sessionId}","href":"/api-reference/agentic-checkout/replace-agentic-checkout-session-fields"},{"title":"Update Agentic Checkout Session","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/checkout-sessions/{sessionId}","href":"/api-reference/agentic-checkout/update-agentic-checkout-session"},{"title":"Cancel Agentic Checkout Session","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/checkout-sessions/{sessionId}/cancel","href":"/api-reference/agentic-checkout/cancel-agentic-checkout-session"},{"title":"Complete Agentic Checkout Session","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/checkout-sessions/{sessionId}/complete","href":"/api-reference/agentic-checkout/complete-agentic-checkout-session"}]},{"group":"Public Agent","pages":[{"title":"Compare Public Products","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/compare","href":"/api-reference/public-agent/compare-public-products"},{"title":"List Public Merchants","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/directory","href":"/api-reference/public-agent/list-public-merchants"},{"title":"Get Merchant LLM Feed","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/feed/{domain}/llms.txt","href":"/api-reference/public-agent/get-merchant-llm-feed"},{"title":"Get Public Merchant Manifest","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/merchants/{merchantId}/manifest","href":"/api-reference/public-agent/get-public-merchant-manifest"},{"title":"List Public Merchant Products","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/merchants/{merchantId}/products","href":"/api-reference/public-agent/list-public-merchant-products"},{"title":"Search Within Public Merchant Catalog","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/merchants/{merchantId}/search","href":"/api-reference/public-agent/search-within-public-merchant-catalog"},{"title":"Search Public Merchant Products","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/search","href":"/api-reference/public-agent/search-public-merchant-products"},{"title":"Search Public Merchant Products","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/search","href":"/api-reference/public-agent/search-public-merchant-products-1"}]},{"group":"Knowledge Base","pages":[{"title":"Upload Document","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/documents","href":"/api-reference/documents/upload-document"},{"title":"Get Document","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/documents/{documentId}","href":"/api-reference/documents/get-document"}]},{"group":"Looks","pages":[{"title":"List Looks","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/looks","href":"/api-reference/looks/list-looks"},{"title":"Create Look","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/looks","href":"/api-reference/looks/create-look"},{"title":"Get Look","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/looks/{lookId}","href":"/api-reference/looks/get-look"}]},{"group":"OAuth","pages":[{"title":"Revoke Access Token","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/oauth/revoke","href":"/api-reference/oauth/revoke-access-token"},{"title":"Get Access Token","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/oauth/token","href":"/api-reference/oauth/get-access-token"}]},{"group":"Orders","pages":[{"title":"List Orders","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/orders","href":"/api-reference/orders/list-orders"},{"title":"Create Order","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/orders","href":"/api-reference/orders/create-order"},{"title":"Get Order","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/orders/{orderId}","href":"/api-reference/orders/get-order"},{"title":"Update Order","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/orders/{orderId}","href":"/api-reference/orders/update-order"},{"title":"Get Order Action Options","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/orders/{orderId}/action-options","href":"/api-reference/orders/get-order-action-options"},{"title":"List Order Actions","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/orders/{orderId}/actions","href":"/api-reference/orders/list-order-actions"},{"title":"Queue Order Action","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/orders/{orderId}/actions","href":"/api-reference/orders/queue-order-action"}]},{"group":"Organizations","pages":[{"title":"Create Organization","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/organizations","href":"/api-reference/organizations/create-organization"}]},{"group":"Price Books","pages":[{"title":"List Price Book Rules","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/price-books","href":"/api-reference/price-books/list-price-book-rules"},{"title":"Create Price Book Rule","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/price-books","href":"/api-reference/price-books/create-price-book-rule"},{"title":"Get Price Book Rule","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/price-books/{ruleId}","href":"/api-reference/price-books/get-price-book-rule"},{"title":"Delete Price Book Rule","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/price-books/{ruleId}","href":"/api-reference/price-books/delete-price-book-rule"},{"title":"Update Price Book Rule","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/price-books/{ruleId}","href":"/api-reference/price-books/update-price-book-rule"},{"title":"Preview Channel List Price","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/price-books/preview","href":"/api-reference/price-books/preview-channel-list-price"}]},{"group":"Promotions","pages":[{"title":"List Promotions","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/promotions","href":"/api-reference/promotions/list-promotions"},{"title":"Create Promotion","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/promotions","href":"/api-reference/promotions/create-promotion"},{"title":"Get Promotion","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/promotions/{promotionId}","href":"/api-reference/promotions/get-promotion"},{"title":"Delete Promotion","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/promotions/{promotionId}","href":"/api-reference/promotions/delete-promotion"},{"title":"Update Promotion","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/promotions/{promotionId}","href":"/api-reference/promotions/update-promotion"},{"title":"List Promotion Assignments","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/promotions/{promotionId}/products","href":"/api-reference/promotions/list-promotion-assignments"},{"title":"Assign Products to Promotion","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/promotions/{promotionId}/products","href":"/api-reference/promotions/assign-products-to-promotion"},{"title":"Unassign Products from Promotion","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/promotions/{promotionId}/products","href":"/api-reference/promotions/unassign-products-from-promotion"},{"title":"Retry Marketplace Delivery","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/promotions/{promotionId}/retry","href":"/api-reference/promotions/retry-marketplace-delivery"}]},{"group":"Returns","pages":[{"title":"List Returns","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/returns","href":"/api-reference/returns/list-returns"},{"title":"Get Return","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/returns/{returnId}","href":"/api-reference/returns/get-return"}]},{"group":"Reviews","pages":[{"title":"List Reviews","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/reviews","href":"/api-reference/reviews/list-reviews"},{"title":"Get Review","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/reviews/{reviewId}","href":"/api-reference/reviews/get-review"},{"title":"Reply to Review","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/reviews/{reviewId}/reply","href":"/api-reference/reviews/reply-to-review"}]},{"group":"Settlements","pages":[{"title":"List Settlements","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/settlements","href":"/api-reference/settlements/list-settlements"},{"title":"Apply Settlements","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/settlements","href":"/api-reference/settlements/apply-settlements"},{"title":"Get Settlement","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/settlements/{settlementId}","href":"/api-reference/settlements/get-settlement"}]},{"group":"UCP","pages":[{"title":"Create UCP Checkout Session","deprecated":null,"version":null,"openapi":"/openapi.json post /ucp/v1/checkout-sessions","href":"/api-reference/ucp/create-ucp-checkout-session"},{"title":"Get UCP Checkout Session","deprecated":null,"version":null,"openapi":"/openapi.json get /ucp/v1/checkout-sessions/{sessionId}","href":"/api-reference/ucp/get-ucp-checkout-session"},{"title":"Replace UCP Checkout Session Fields","deprecated":null,"version":null,"openapi":"/openapi.json put /ucp/v1/checkout-sessions/{sessionId}","href":"/api-reference/ucp/replace-ucp-checkout-session-fields"},{"title":"Update UCP Checkout Session","deprecated":null,"version":null,"openapi":"/openapi.json patch /ucp/v1/checkout-sessions/{sessionId}","href":"/api-reference/ucp/update-ucp-checkout-session"},{"title":"Cancel UCP Checkout Session","deprecated":null,"version":null,"openapi":"/openapi.json post /ucp/v1/checkout-sessions/{sessionId}/cancel","href":"/api-reference/ucp/cancel-ucp-checkout-session"},{"title":"Complete UCP Checkout Session","deprecated":null,"version":null,"openapi":"/openapi.json post /ucp/v1/checkout-sessions/{sessionId}/complete","href":"/api-reference/ucp/complete-ucp-checkout-session"},{"title":"Get UCP Order","deprecated":null,"version":null,"openapi":"/openapi.json get /ucp/v1/orders/{orderId}","href":"/api-reference/ucp/get-ucp-order"}]},{"group":"product webhooks","pages":[]},{"group":"enrichment webhooks","pages":[]},{"group":"look webhooks","pages":[]},{"group":"review webhooks","pages":[]},{"group":"order webhooks","pages":[]},{"group":"settlement webhooks","pages":[]},{"group":"return webhooks","pages":[]},{"group":"account statement webhooks","pages":[]}]},{"group":"Webhooks","pages":[{"group":"Product","pages":[{"title":"Product created","openapi":"openapi.json webhook productCreated","href":"/webhooks/reference/product-created"},{"title":"Product updated","openapi":"openapi.json webhook productUpdated","href":"/webhooks/reference/product-updated"},{"title":"Product deleted","openapi":"openapi.json webhook productDeleted","href":"/webhooks/reference/product-deleted"},{"title":"Product delisted","openapi":"openapi.json webhook productDelisted","href":"/webhooks/reference/product-delisted"},{"title":"Product price changed","openapi":"openapi.json webhook productPriceChanged","href":"/webhooks/reference/product-price-changed"},{"title":"Product inventory changed","openapi":"openapi.json webhook productInventoryChanged","href":"/webhooks/reference/product-inventory-changed"}]},{"group":"Orders","pages":[{"title":"Order created","openapi":"openapi.json webhook orderCreated","href":"/webhooks/reference/order-created"},{"title":"Order updated","openapi":"openapi.json webhook orderUpdated","href":"/webhooks/reference/order-updated"},{"title":"Order status changed","openapi":"openapi.json webhook orderStatusChanged","href":"/webhooks/reference/order-status-changed"},{"title":"Order deleted","openapi":"openapi.json webhook orderDeleted","href":"/webhooks/reference/order-deleted"}]},{"group":"Looks","pages":[{"title":"Look created","openapi":"openapi.json webhook lookCreated","href":"/webhooks/reference/look-created"},{"title":"Look deleted","openapi":"openapi.json webhook lookDeleted","href":"/webhooks/reference/look-deleted"}]},{"group":"Review","pages":[{"title":"Review created","openapi":"openapi.json webhook reviewCreated","href":"/webhooks/reference/review-created"},{"title":"Review updated","openapi":"openapi.json webhook reviewUpdated","href":"/webhooks/reference/review-updated"},{"title":"Review status changed","openapi":"openapi.json webhook reviewStatusChanged","href":"/webhooks/reference/review-status-changed"}]},{"group":"Settlements","pages":[{"title":"Settlement created","openapi":"openapi.json webhook settlementCreated","href":"/webhooks/reference/settlement-created"},{"title":"Settlement updated","openapi":"openapi.json webhook settlementUpdated","href":"/webhooks/reference/settlement-updated"},{"title":"Settlement status changed","openapi":"openapi.json webhook settlementStatusChanged","href":"/webhooks/reference/settlement-status-changed"}]},{"group":"Returns","pages":[{"title":"Return created","openapi":"openapi.json webhook returnCreated","href":"/webhooks/reference/return-created"},{"title":"Return updated","openapi":"openapi.json webhook returnUpdated","href":"/webhooks/reference/return-updated"},{"title":"Return status changed","openapi":"openapi.json webhook returnStatusChanged","href":"/webhooks/reference/return-status-changed"}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"title":"Bulk Import Products from JSON or CSV - OmniCommerce","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","Page-n7I5XbKb.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js","Markdown--GF7ZIpf.js","clsx-DZLdJUrt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-2LoAhjKH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Zwc0ZncM.js"]}