Create a product for the vendor in vendorId. It goes straight to Shopify without product approval, and vendor-side restrictions don’t apply; title, price and metafield rules still do. Send the full set of metafields: any left out are deleted.
JWT minted from a merchant API key (mk_live_…) by POST /authenticate. Send the token value directly, with no "Bearer" prefix. Tokens last 14 days and can be renewed at POST /refresh-token; revoking the key refuses the next request made with any token minted from it.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"PuppetVendors API","colors":{"primary":"#6366F1","light":"#818CF8","dark":"#4F46E5"},"logo":{"light":"https://mintcdn.com/puppetvendors-26/j4NQfmVPdX-HgZdK/logo/light.svg?fit=max\u0026auto=format\u0026n=j4NQfmVPdX-HgZdK\u0026q=85\u0026s=334773803bc34a3293e61a5efa488140","dark":"https://mintcdn.com/puppetvendors-26/j4NQfmVPdX-HgZdK/logo/dark.svg?fit=max\u0026auto=format\u0026n=j4NQfmVPdX-HgZdK\u0026q=85\u0026s=203f04ba19ba014e8b2e5d16adb535dd"},"favicon":"https://mintcdn.com/puppetvendors-26/sD9D69AzyUrevT_4/favicon.svg?fit=max\u0026auto=format\u0026n=sD9D69AzyUrevT_4\u0026q=85\u0026s=da8f4187f7e57f1a74e0b540a4b31f87","api":{"mdx":{"auth":{"method":"key","name":"x-access-token"},"server":"https://production-api.puppetvendors.com"}},"navbar":{"links":[{"href":"mailto:support@puppetvendors.com","label":"Support"}]},"footer":{},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"PuppetVendors","icon":"globe","href":"https://puppetvendors.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"puppetvendors-26","hasAudioNarration":false,"actualSubdomain":"puppetvendors-26","customDomains":["dev.puppetvendors.com"],"gitSource":{"type":"github","owner":"puppetvendors","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adcc9066fc254ddb8b5a521","collectionId":"33f503ca-cd30-4bbe-aa56-28a6f3f9555d","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adcc9066fc254ddb8b5a521"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6adcc9066fc254ddb8b5a521","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"default","tag":"Vendors - V2","count":100},{"language":"default","tag":"Merchants - V2","count":48},{"language":"default","tag":"API V1","count":27},{"language":"default","tag":"Products","count":27},{"language":"default","tag":"Vendors","count":19},{"language":"default","tag":"Payouts","count":16},{"language":"default","tag":"Users","count":15},{"language":"default","tag":"Integrations","count":13},{"language":"default","tag":"Getting Started","count":10},{"language":"default","tag":"Fulfillments","count":7}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","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":"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":"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":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","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":"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":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/v2/merchant/endpoint/create-product","slug":"/api-reference/v2/merchant/endpoint/create-product","pageMetadata":{"openapi":"openapi-merchant.json POST /products","title":"Create a product","description":"Create a product for the vendor in `vendorId`. It goes straight to Shopify without product approval, and vendor-side restrictions don't apply; title, price and metafield rules still do. Send the full set of metafields: any left out are deleted.","href":"/api-reference/v2/merchant/endpoint/create-product"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Create a product for the vendor in \", _jsx(_components.code, {\n children: \"vendorId\"\n }), \". It goes straight to Shopify without product approval, and vendor-side restrictions don’t apply; title, price and metafield rules still do. Send the full set of metafields: any left out are deleted.\"]\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":{"openapi":"openapi-merchant.json POST /products","title":"Create a product","description":"Create a product for the vendor in `vendorId`. It goes straight to Shopify without product approval, and vendor-side restrictions don't apply; title, price and metafield rules still do. Send the full set of metafields: any left out are deleted.","href":"/api-reference/v2/merchant/endpoint/create-product"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Merchant Products"],"summary":"Create a product","description":"Create a product for the vendor in `vendorId`. It goes straight to Shopify without product approval, and vendor-side restrictions don't apply; title, price and metafield rules still do. Send the full set of metafields: any left out are deleted.","operationId":"merchantCreateProduct","security":["54c33ab0-517e-4a0c-8c40-08e0992a7a0e"],"requestBody":"d8b39a9e-2fa2-4f07-806a-3143de2d8796","responses":{"201":"a5785efa-1852-4a17-8d57-b701fbbdc4a8","400":"eea75e8c-82d8-441b-bfbd-2329a6ce99f2","401":"bcaa9319-9267-4fab-b58b-bebc4f42887c","403":"2c4657b6-2e08-4015-9412-5fa4196256c1","409":"4d199dd9-d563-44c8-b3f3-e807f4b4f176","422":"7f7e41f9-bf64-4154-aeec-889d9ce6de6b"},"method":"post","type":"path","servers":["2db9fc60-25d9-439d-a78c-11a94ea1b52b","0ac88649-853d-49c9-b889-36f894ea7b65"],"path":"/products","baseUrlOptions":["https://production-api.puppetvendors.com","http://localhost:8082"],"title":"Create a product","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["title","vendorId","variants"],"properties":{"title":{"type":"string","minLength":1,"maxLength":255,"description":"Product title","example":"Widget Pro Deluxe","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"vendorId":{"type":"string","description":"Vendor ObjectId","example":"507f1f77bcf86cd799439011","isRequired":true,"uniqueKey":"vendorId","typeLabel":"string"},"variants":{"type":"array","items":{"type":"object","properties":{"price":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$","description":"Variant price","example":"29.99","isRequired":true,"uniqueKey":"variants.items.[INDEX].price","typeLabel":"string"},"optionValues":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","example":"Color","uniqueKey":"variants.items.[INDEX].optionValues.items.[INDEX].name","typeLabel":"string"},"value":{"type":"string","example":"Red","uniqueKey":"variants.items.[INDEX].optionValues.items.[INDEX].value","typeLabel":"string"}},"uniqueKey":"variants.items.[INDEX].optionValues.items.[INDEX]","typeLabel":"object"},"description":"Option values for this variant","uniqueKey":"variants.items.[INDEX].optionValues","typeLabel":"object[]"},"compareAtPrice":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$","description":"Original/compare price","example":"39.99","uniqueKey":"variants.items.[INDEX].compareAtPrice","typeLabel":"string"},"sku":{"type":"string","maxLength":255,"description":"Stock keeping unit","example":"WIDGET-RED-L","uniqueKey":"variants.items.[INDEX].sku","typeLabel":"string"},"barcode":{"type":"string","maxLength":255,"description":"EAN/barcode","uniqueKey":"variants.items.[INDEX].barcode","typeLabel":"string"},"inventoryQuantity":{"type":"integer","minimum":-1000000000,"maximum":1000000000,"description":"Inventory quantity at location. May be negative for oversold or backordered stock, which only actually sells when the variant inventoryPolicy is CONTINUE.","example":100,"uniqueKey":"variants.items.[INDEX].inventoryQuantity","typeLabel":"integer"},"locationId":{"type":"string","description":"Shopify location ID (required if inventoryQuantity is provided)","example":"gid://shopify/Location/123456","uniqueKey":"variants.items.[INDEX].locationId","typeLabel":"string"},"requiresShipping":{"type":"boolean","description":"Whether variant requires shipping","example":true,"uniqueKey":"variants.items.[INDEX].requiresShipping","typeLabel":"boolean"},"taxable":{"type":"boolean","description":"Whether variant is taxable","example":true,"uniqueKey":"variants.items.[INDEX].taxable","typeLabel":"boolean"},"inventoryPolicy":{"type":"string","enum":["DENY","CONTINUE"],"description":"Behavior when out of stock","example":"DENY","uniqueKey":"variants.items.[INDEX].inventoryPolicy","typeLabel":"enum\u003cstring>"}},"required":["price"],"uniqueKey":"variants.items.[INDEX]","typeLabel":"object"},"maxItems":100,"description":"At least one variant. Every variant needs a `price` (string, e.g. \"1.00\"), or the request returns 400 `PRICE_REQUIRED`.","minItems":1,"isRequired":true,"uniqueKey":"variants","typeLabel":"object[]"},"descriptionHtml":{"type":"string","description":"Product description in HTML","example":"\u003cp>Premium widget with advanced features\u003c/p>","uniqueKey":"descriptionHtml","typeLabel":"string"},"productType":{"type":"string","maxLength":255,"description":"Product type/category","example":"Widgets","uniqueKey":"productType","typeLabel":"string"},"tags":{"type":"array","items":{"type":"string","maxLength":255,"uniqueKey":"tags.items.[INDEX]","typeLabel":"string"},"maxItems":250,"description":"Product tags","example":["premium","bestseller","new"],"uniqueKey":"tags","typeLabel":"string[]"},"status":{"type":"string","enum":["ACTIVE","DRAFT","ARCHIVED"],"description":"Product status","example":"DRAFT","uniqueKey":"status","typeLabel":"enum\u003cstring>"},"handle":{"type":"string","maxLength":255,"description":"URL-friendly product handle","example":"widget-pro-deluxe","uniqueKey":"handle","typeLabel":"string"},"options":{"type":"array","items":{"type":"object","required":["name","values"],"properties":{"name":{"type":"string","description":"Option name (e.g., Color, Size)","example":"Color","isRequired":true,"uniqueKey":"options.items.[INDEX].name","typeLabel":"string"},"values":{"type":"array","items":{"type":"string","uniqueKey":"options.items.[INDEX].values.items.[INDEX]","typeLabel":"string"},"description":"Possible values for this option","example":["Red","Blue","Green"],"isRequired":true,"uniqueKey":"options.items.[INDEX].values","typeLabel":"string[]"}},"uniqueKey":"options.items.[INDEX]","typeLabel":"object"},"maxItems":3,"description":"Product options (e.g., Color, Size)","uniqueKey":"options","typeLabel":"object[]"},"metafields":{"type":"array","items":{"type":"object","required":["namespace","key","value"],"properties":{"namespace":{"type":"string","description":"Metafield namespace","example":"custom","isRequired":true,"uniqueKey":"metafields.items.[INDEX].namespace","typeLabel":"string"},"key":{"type":"string","description":"Metafield key","example":"color_family","isRequired":true,"uniqueKey":"metafields.items.[INDEX].key","typeLabel":"string"},"value":{"type":"string","description":"Metafield value","example":"red","isRequired":true,"uniqueKey":"metafields.items.[INDEX].value","typeLabel":"string"},"type":{"type":"string","description":"Metafield type","example":"single_line_text_field","uniqueKey":"metafields.items.[INDEX].type","typeLabel":"string"},"description":{"type":"string","description":"Metafield description","uniqueKey":"metafields.items.[INDEX].description","typeLabel":"string"}},"uniqueKey":"metafields.items.[INDEX]","typeLabel":"object"},"description":"Custom metafields","uniqueKey":"metafields","typeLabel":"object[]"},"seo":{"type":"object","properties":{"title":{"type":"string","maxLength":255,"description":"SEO title tag","example":"Premium Widget - Best Price Online","uniqueKey":"seo.title","typeLabel":"string"},"description":{"type":"string","maxLength":320,"description":"SEO meta description","example":"High-quality widgets at competitive prices. Free shipping on orders over $50.","uniqueKey":"seo.description","typeLabel":"string"}},"description":"SEO settings","uniqueKey":"seo","typeLabel":"object"},"category":{"type":"string","description":"Product category/collection","example":"Electronics","uniqueKey":"category","typeLabel":"string"},"templateSuffix":{"type":"string","description":"Custom template suffix","uniqueKey":"templateSuffix","typeLabel":"string"},"images":{"type":"array","maxItems":250,"description":"Product images (replaces existing on update)","items":{"type":"object","required":["src"],"properties":{"src":{"type":"string","format":"uri","example":"https://cdn.example.com/widget.jpg","isRequired":true,"uniqueKey":"images.items.[INDEX].src","typeLabel":"string\u003curi>"},"altText":{"type":"string","maxLength":255,"uniqueKey":"images.items.[INDEX].altText","typeLabel":"string"}},"uniqueKey":"images.items.[INDEX]","typeLabel":"object"},"uniqueKey":"images","typeLabel":"object[]"},"medias":{"type":"array","maxItems":250,"description":"Digital files for download after purchase. On update, omit to keep existing files.","items":{"type":"object","required":["file","name"],"properties":{"file":{"type":"string","format":"uri","description":"https URL of the uploaded file","isRequired":true,"uniqueKey":"medias.items.[INDEX].file","typeLabel":"string\u003curi>"},"name":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"medias.items.[INDEX].name","typeLabel":"string"},"size":{"type":"integer","minimum":0,"uniqueKey":"medias.items.[INDEX].size","typeLabel":"integer"},"type":{"type":"string","maxLength":255,"uniqueKey":"medias.items.[INDEX].type","typeLabel":"string"},"variant":{"type":"string","maxLength":255,"uniqueKey":"medias.items.[INDEX].variant","typeLabel":"string"},"variantId":{"type":"string","maxLength":255,"uniqueKey":"medias.items.[INDEX].variantId","typeLabel":"string"},"assignedTo":{"type":"string","maxLength":255,"uniqueKey":"medias.items.[INDEX].assignedTo","typeLabel":"string"}},"uniqueKey":"medias.items.[INDEX]","typeLabel":"object"},"uniqueKey":"medias","typeLabel":"object[]"},"vendor":{"type":"string","description":"Vendor display name on the Shopify product","uniqueKey":"vendor","typeLabel":"string"},"brandName":{"type":"string","description":"Brand name","uniqueKey":"brandName","typeLabel":"string"},"collections":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"collections.items.[INDEX]","typeLabel":"string"},"description":"Shopify collection ids to add the new product to.","maxItems":250,"uniqueKey":"collections","typeLabel":"string[]"},"isDigital":{"type":"boolean","description":"Marks the product as a digital product (use with medias)","uniqueKey":"isDigital","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"title":"Widget Pro Deluxe","vendorId":"507f1f77bcf86cd799439011","variants":[{"price":"29.99","optionValues":[{"name":"Color","value":"Red"}],"compareAtPrice":"39.99","sku":"WIDGET-RED-L","barcode":"\u003cstring>","inventoryQuantity":100,"locationId":"gid://shopify/Location/123456","requiresShipping":true,"taxable":true,"inventoryPolicy":"DENY"}],"descriptionHtml":"\u003cp>Premium widget with advanced features\u003c/p>","productType":"Widgets","tags":["premium","bestseller","new"],"status":"DRAFT","handle":"widget-pro-deluxe","options":[{"name":"Color","values":["Red","Blue","Green"]}],"metafields":[{"namespace":"custom","key":"color_family","value":"red","type":"single_line_text_field","description":"\u003cstring>"}],"seo":{"title":"Premium Widget - Best Price Online","description":"High-quality widgets at competitive prices. Free shipping on orders over $50."},"category":"Electronics","templateSuffix":"\u003cstring>","images":[{"src":"https://cdn.example.com/widget.jpg","altText":"\u003cstring>"}],"medias":[{"file":"\u003cstring>","name":"\u003cstring>","size":1,"type":"\u003cstring>","variant":"\u003cstring>","variantId":"\u003cstring>","assignedTo":"\u003cstring>"}],"vendor":"\u003cstring>","brandName":"\u003cstring>","collections":["\u003cstring>"],"isDigital":true}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"a5785efa-1852-4a17-8d57-b701fbbdc4a8":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[true],"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"data":{"type":"object","properties":{"_id":{"type":"string","description":"Product ObjectId","example":"507f1f77bcf86cd799439013","uniqueKey":"data._id","typeLabel":"string"},"title":{"type":"string","description":"Product title","example":"Widget Pro","uniqueKey":"data.title","typeLabel":"string"},"handle":{"type":"string","description":"URL-friendly product handle","example":"widget-pro","uniqueKey":"data.handle","typeLabel":"string"},"status":{"type":"string","enum":["active","draft","archived"],"description":"Product status","example":"active","uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"vendorId":{"type":"string","description":"Associated vendor ObjectId","example":"507f1f77bcf86cd799439011","uniqueKey":"data.vendorId","typeLabel":"string"},"variants":{"type":"array","items":{"type":"object","properties":{"_id":{"type":"string","description":"Mongo subdocument id","uniqueKey":"data.variants.items.[INDEX]._id","typeLabel":"string"},"id":{"type":"string","description":"Shopify variant id (numeric) once synced","uniqueKey":"data.variants.items.[INDEX].id","typeLabel":"string"},"admin_graphql_api_id":{"type":"string","description":"Shopify variant GID once synced","uniqueKey":"data.variants.items.[INDEX].admin_graphql_api_id","typeLabel":"string"},"title":{"type":"string","description":"Variant title (e.g. \"Red / Large\")","uniqueKey":"data.variants.items.[INDEX].title","typeLabel":"string"},"sku":{"type":"string","uniqueKey":"data.variants.items.[INDEX].sku","typeLabel":"string"},"price":{"type":"number","uniqueKey":"data.variants.items.[INDEX].price","typeLabel":"number"},"inventory":{"type":"number","uniqueKey":"data.variants.items.[INDEX].inventory","typeLabel":"number"},"optionValues":{"type":"array","description":"Resolved option name/value pairs","items":{"type":"object","properties":{"name":{"type":"string","uniqueKey":"data.variants.items.[INDEX].optionValues.items.[INDEX].name","typeLabel":"string"},"value":{"type":"string","uniqueKey":"data.variants.items.[INDEX].optionValues.items.[INDEX].value","typeLabel":"string"}},"uniqueKey":"data.variants.items.[INDEX].optionValues.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.variants.items.[INDEX].optionValues","typeLabel":"object[]"},"selectedOptions":{"type":"array","description":"Shopify-shaped option name/value pairs","items":{"type":"object","properties":{"name":{"type":"string","uniqueKey":"data.variants.items.[INDEX].selectedOptions.items.[INDEX].name","typeLabel":"string"},"value":{"type":"string","uniqueKey":"data.variants.items.[INDEX].selectedOptions.items.[INDEX].value","typeLabel":"string"}},"uniqueKey":"data.variants.items.[INDEX].selectedOptions.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.variants.items.[INDEX].selectedOptions","typeLabel":"object[]"},"inventoryQuantities":{"type":"array","description":"Per-location stock for this variant","items":{"type":"object","properties":{"locationId":{"type":"string","uniqueKey":"data.variants.items.[INDEX].inventoryQuantities.items.[INDEX].locationId","typeLabel":"string"},"name":{"type":"string","uniqueKey":"data.variants.items.[INDEX].inventoryQuantities.items.[INDEX].name","typeLabel":"string"},"quantity":{"type":"integer","uniqueKey":"data.variants.items.[INDEX].inventoryQuantities.items.[INDEX].quantity","typeLabel":"integer"},"availableQuantity":{"type":"integer","uniqueKey":"data.variants.items.[INDEX].inventoryQuantities.items.[INDEX].availableQuantity","typeLabel":"integer"}},"uniqueKey":"data.variants.items.[INDEX].inventoryQuantities.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.variants.items.[INDEX].inventoryQuantities","typeLabel":"object[]"}},"uniqueKey":"data.variants.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.variants","typeLabel":"object[]"},"createdAt":{"type":"string","format":"date-time","uniqueKey":"data.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","uniqueKey":"data.updatedAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"data":{"_id":"507f1f77bcf86cd799439013","title":"Widget Pro","handle":"widget-pro","status":"active","vendorId":"507f1f77bcf86cd799439011","variants":[{"_id":"\u003cstring>","id":"\u003cstring>","admin_graphql_api_id":"\u003cstring>","title":"\u003cstring>","sku":"\u003cstring>","price":123,"inventory":123,"optionValues":[{"name":"\u003cstring>","value":"\u003cstring>"}],"selectedOptions":[{"name":"\u003cstring>","value":"\u003cstring>"}],"inventoryQuantities":[{"locationId":"\u003cstring>","name":"\u003cstring>","quantity":123,"availableQuantity":123}]}],"createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"eea75e8c-82d8-441b-bfbd-2329a6ce99f2":{"description":"VENDOR_REQUIRED, PRODUCT_VALIDATION_FAILED, or VALIDATION_ERROR for an invalid body or an unsupported field: `error.details` lists each unsupported field with the code `unrecognized_keys` and a message naming the field to use instead. `PRICE_REQUIRED`: a variant has no price. Fix: send `variants: [{\"price\": \"1.00\"}]`.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","enum":[false],"description":"Indicates the request failed","isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"error":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"Human-readable error message","example":"Resource not found","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code. The frontend uses this as its localisation key (e.g. errors.api.\u003ccode>). Server errors always report INTERNAL_SERVER_ERROR.","example":"NOT_FOUND","uniqueKey":"error.code","typeLabel":"string"},"errorId":{"type":"string","description":"Correlation id for support/log lookup. Present on opaque 5xx responses so a user can quote a reference for the underlying (server-side logged) error.","example":"err_1783365360839_j281w7b","uniqueKey":"error.errorId","typeLabel":"string"},"details":{"type":"object","description":"Additional client-error context (e.g. field-level validation errors). Never populated for server errors.","uniqueKey":"error.details","typeLabel":"object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"message":"Resource not found","code":"NOT_FOUND","errorId":"err_1783365360839_j281w7b","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"bcaa9319-9267-4fab-b58b-bebc4f42887c":{"description":"Missing, invalid or revoked token","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","enum":[false],"description":"Indicates the request failed","isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"error":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"Human-readable error message","example":"Resource not found","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code. The frontend uses this as its localisation key (e.g. errors.api.\u003ccode>). Server errors always report INTERNAL_SERVER_ERROR.","example":"NOT_FOUND","uniqueKey":"error.code","typeLabel":"string"},"errorId":{"type":"string","description":"Correlation id for support/log lookup. Present on opaque 5xx responses so a user can quote a reference for the underlying (server-side logged) error.","example":"err_1783365360839_j281w7b","uniqueKey":"error.errorId","typeLabel":"string"},"details":{"type":"object","description":"Additional client-error context (e.g. field-level validation errors). Never populated for server errors.","uniqueKey":"error.details","typeLabel":"object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"message":"Resource not found","code":"NOT_FOUND","errorId":"err_1783365360839_j281w7b","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"2c4657b6-2e08-4015-9412-5fa4196256c1":{"description":"Not a merchant API key, or vendorId is not a vendor of this shop","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","enum":[false],"description":"Indicates the request failed","isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"error":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"Human-readable error message","example":"Resource not found","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code. The frontend uses this as its localisation key (e.g. errors.api.\u003ccode>). Server errors always report INTERNAL_SERVER_ERROR.","example":"NOT_FOUND","uniqueKey":"error.code","typeLabel":"string"},"errorId":{"type":"string","description":"Correlation id for support/log lookup. Present on opaque 5xx responses so a user can quote a reference for the underlying (server-side logged) error.","example":"err_1783365360839_j281w7b","uniqueKey":"error.errorId","typeLabel":"string"},"details":{"type":"object","description":"Additional client-error context (e.g. field-level validation errors). Never populated for server errors.","uniqueKey":"error.details","typeLabel":"object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"message":"Resource not found","code":"NOT_FOUND","errorId":"err_1783365360839_j281w7b","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"4d199dd9-d563-44c8-b3f3-e807f4b4f176":{"description":"PRODUCT_HANDLE_TAKEN","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","enum":[false],"description":"Indicates the request failed","isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"error":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"Human-readable error message","example":"Resource not found","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code. The frontend uses this as its localisation key (e.g. errors.api.\u003ccode>). Server errors always report INTERNAL_SERVER_ERROR.","example":"NOT_FOUND","uniqueKey":"error.code","typeLabel":"string"},"errorId":{"type":"string","description":"Correlation id for support/log lookup. Present on opaque 5xx responses so a user can quote a reference for the underlying (server-side logged) error.","example":"err_1783365360839_j281w7b","uniqueKey":"error.errorId","typeLabel":"string"},"details":{"type":"object","description":"Additional client-error context (e.g. field-level validation errors). Never populated for server errors.","uniqueKey":"error.details","typeLabel":"object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"message":"Resource not found","code":"NOT_FOUND","errorId":"err_1783365360839_j281w7b","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"7f7e41f9-bf64-4154-aeec-889d9ce6de6b":{"description":"Shopify refused the product (SHOPIFY_OPERATION_FAILED, details.shopifyErrors)","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","enum":[false],"description":"Indicates the request failed","isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"error":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"Human-readable error message","example":"Resource not found","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code. The frontend uses this as its localisation key (e.g. errors.api.\u003ccode>). Server errors always report INTERNAL_SERVER_ERROR.","example":"NOT_FOUND","uniqueKey":"error.code","typeLabel":"string"},"errorId":{"type":"string","description":"Correlation id for support/log lookup. Present on opaque 5xx responses so a user can quote a reference for the underlying (server-side logged) error.","example":"err_1783365360839_j281w7b","uniqueKey":"error.errorId","typeLabel":"string"},"details":{"type":"object","description":"Additional client-error context (e.g. field-level validation errors). Never populated for server errors.","uniqueKey":"error.details","typeLabel":"object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"message":"Resource not found","code":"NOT_FOUND","errorId":"err_1783365360839_j281w7b","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"54c33ab0-517e-4a0c-8c40-08e0992a7a0e":{"bearerAuth":{"type":"apiKey","in":"header","name":"x-access-token","description":"JWT minted from a merchant API key (`mk_live_…`) by POST /authenticate. Send the token value directly, with no \"Bearer\" prefix. Tokens last 14 days and can be renewed at POST /refresh-token; revoking the key refuses the next request made with any token minted from it.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"2db9fc60-25d9-439d-a78c-11a94ea1b52b":{"url":"https://production-api.puppetvendors.com","description":"Production"},"0ac88649-853d-49c9-b889-36f894ea7b65":{"url":"http://localhost:8082","description":"Local development"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-access-token","description":"JWT minted from a merchant API key (`mk_live_…`) by POST /authenticate. Send the token value directly, with no \"Bearer\" prefix. Tokens last 14 days and can be renewed at POST /refresh-token; revoking the key refuses the next request made with any token minted from it.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"x-access-token","type":"string","description":"JWT minted from a merchant API key (`mk_live_…`) by POST /authenticate. Send the token value directly, with no \"Bearer\" prefix. Tokens last 14 days and can be renewed at POST /refresh-token; revoking the key refuses the next request made with any token minted from it.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"bearerAuth","name":"x-access-token"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi-merchant.json"},"subdomain":"puppetvendors-26","siteName":"PuppetVendors API","title":"Create a product - PuppetVendors API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-24T15:04:48.731Z","originalFileLocation":"api-reference/v2/merchant/endpoint/create-product.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create a product for the vendor in vendorId. It goes straight to Shopify without product approval, and vendor-side restrictions don\u0026#x27;t apply; title, price and metafield rules still do. Send the full set of metafields: any left out are deleted.\">\u003cmeta data-mint-head name=\"application-name\" content=\"PuppetVendors API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/puppetvendors-26/-XB4Lj4GMnwBz779/_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/puppetvendors-26/-XB4Lj4GMnwBz779/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/puppetvendors-26/-XB4Lj4GMnwBz779/_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/puppetvendors-26/-XB4Lj4GMnwBz779/_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/puppetvendors-26/-XB4Lj4GMnwBz779/_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/puppetvendors-26/-XB4Lj4GMnwBz779/_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/puppetvendors-26/-XB4Lj4GMnwBz779/_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/puppetvendors-26/-XB4Lj4GMnwBz779/_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/puppetvendors-26/-XB4Lj4GMnwBz779/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a product - PuppetVendors API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a product for the vendor in vendorId. It goes straight to Shopify without product approval, and vendor-side restrictions don\u0026#x27;t apply; title, price and metafield rules still do. Send the full set of metafields: any left out are deleted.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"PuppetVendors API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://dev.puppetvendors.com/api-reference/v2/merchant/endpoint/create-product\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://puppetvendors-26.mintlify.site/_mintlify/api/og/v2?division=Products\u0026amp;title=Create+a+product\u0026amp;description=Create+a+product+for+the+vendor+in+%60vendorId%60.+It+goes+straight+to+Shopify+without+product+approval%2C+and+vendor-side+restrictions+don%27t+apply%3B+title%2C+price+and+\u0026amp;theme=2ff8e5864df176daa8d300ce\u0026amp;signature=3f71c9e1d2fd237b76aeddfd9b77a2a98ddaeac7d2a6a47f4d14a07609656b64\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a product - PuppetVendors API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a product for the vendor in vendorId. It goes straight to Shopify without product approval, and vendor-side restrictions don\u0026#x27;t apply; title, price and metafield rules still do. Send the full set of metafields: any left out are deleted.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://puppetvendors-26.mintlify.site/_mintlify/api/og/v2?division=Products\u0026amp;title=Create+a+product\u0026amp;description=Create+a+product+for+the+vendor+in+%60vendorId%60.+It+goes+straight+to+Shopify+without+product+approval%2C+and+vendor-side+restrictions+don%27t+apply%3B+title%2C+price+and+\u0026amp;theme=2ff8e5864df176daa8d300ce\u0026amp;signature=3f71c9e1d2fd237b76aeddfd9b77a2a98ddaeac7d2a6a47f4d14a07609656b64\">\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/puppetvendors-26/-XB4Lj4GMnwBz779/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"PuppetVendors API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6366F1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://dev.puppetvendors.com/api-reference/v2/merchant/endpoint/create-product\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/v2/merchant/endpoint/create-product.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://dev.puppetvendors.com/#organization\",\"name\":\"PuppetVendors API\",\"url\":\"https://dev.puppetvendors.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/puppetvendors-26/j4NQfmVPdX-HgZdK/logo/light.svg?fit=max\u0026auto=format\u0026n=j4NQfmVPdX-HgZdK\u0026q=85\u0026s=334773803bc34a3293e61a5efa488140\"}},{\"@type\":\"WebSite\",\"@id\":\"https://dev.puppetvendors.com#website\",\"name\":\"PuppetVendors API\",\"url\":\"https://dev.puppetvendors.com\",\"publisher\":{\"@id\":\"https://dev.puppetvendors.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://dev.puppetvendors.com/api-reference/v2/merchant/endpoint/create-product#webpage\",\"url\":\"https://dev.puppetvendors.com/api-reference/v2/merchant/endpoint/create-product\",\"name\":\"Create a product\",\"description\":\"Create a product for the vendor in vendorId. It goes straight to Shopify without product approval, and vendor-side restrictions don't apply; title, price and metafield rules still do. Send the full set of metafields: any left out are deleted.\",\"dateModified\":\"2026-10-24T15:04:48.731Z\",\"isPartOf\":{\"@id\":\"https://dev.puppetvendors.com#website\"},\"breadcrumb\":{\"@id\":\"https://dev.puppetvendors.com/api-reference/v2/merchant/endpoint/create-product#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://dev.puppetvendors.com/api-reference/v2/merchant/endpoint/create-product#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Products\",\"item\":\"https://dev.puppetvendors.com/api-reference/v2/merchant/endpoint/list-products\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a product\",\"item\":\"https://dev.puppetvendors.com/api-reference/v2/merchant/endpoint/create-product\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://dev.puppetvendors.com/api-reference/v2/merchant/endpoint/create-product#apireference\",\"headline\":\"Create a product\",\"name\":\"Create a product\",\"description\":\"Create a product for the vendor in vendorId. It goes straight to Shopify without product approval, and vendor-side restrictions don't apply; title, price and metafield rules still do. Send the full set of metafields: any left out are deleted.\",\"url\":\"https://dev.puppetvendors.com/api-reference/v2/merchant/endpoint/create-product\",\"mainEntityOfPage\":{\"@id\":\"https://dev.puppetvendors.com/api-reference/v2/merchant/endpoint/create-product#webpage\"},\"dateModified\":\"2026-10-24T15:04:48.731Z\",\"publisher\":{\"@id\":\"https://dev.puppetvendors.com/#organization\"},\"isPartOf\":{\"@id\":\"https://dev.puppetvendors.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"PuppetVendors API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"PuppetVendors API","nav":{"global":{"anchors":[{"anchor":"PuppetVendors","icon":"globe","href":"https://puppetvendors.com"}]},"tabs":[{"tab":"API V1","pages":[{"title":"API V1","href":""}]},{"tab":"Vendors - V2","pages":[{"title":"Vendors - V2","href":"/api-reference/v2/vendor/introduction"}]},{"tab":"Merchants - V2","groups":[{"group":"Getting Started","pages":[{"title":"V2 Merchant API Introduction","href":"/api-reference/v2/merchant/introduction"},{"title":"Merchant Authentication","href":"/api-reference/v2/merchant/authentication"}]},{"group":"Authentication","pages":[{"openapi":"openapi-merchant.json POST /authenticate","title":"Authenticate and get API token","href":"/api-reference/v2/merchant/endpoint/authenticate"},{"openapi":"openapi-merchant.json POST /verify","title":"Verify an API key reaches the service","href":"/api-reference/v2/merchant/endpoint/verify"},{"openapi":"openapi-merchant.json POST /refresh-token","title":"Refresh API token","href":"/api-reference/v2/merchant/endpoint/refresh-token"}]},{"group":"Guides","pages":[{"title":"Pay vendors with the API","href":"/api-reference/v2/merchant/guides/pay-vendors"}]},{"group":"Vendors","pages":[{"openapi":"openapi-merchant.json GET /vendors","title":"List vendors with pagination","href":"/api-reference/v2/merchant/endpoint/list-vendors"},{"openapi":"openapi-merchant.json POST /vendors","title":"Create a new vendor","href":"/api-reference/v2/merchant/endpoint/create-vendor"},{"openapi":"openapi-merchant.json GET /vendors/{vendorId}","title":"Get a single vendor","href":"/api-reference/v2/merchant/endpoint/get-vendor"},{"openapi":"openapi-merchant.json PUT /vendors/{vendorId}","title":"Update a vendor","href":"/api-reference/v2/merchant/endpoint/update-vendor"},{"openapi":"openapi-merchant.json DELETE /vendors/{vendorId}","title":"Delete a vendor (soft delete)","href":"/api-reference/v2/merchant/endpoint/delete-vendor"},{"openapi":"openapi-merchant.json GET /vendors/{vendorId}/profile","title":"Get vendor profile","href":"/api-reference/v2/merchant/endpoint/get-vendor-profile"},{"openapi":"openapi-merchant.json PUT /vendors/{vendorId}/profile","title":"Update vendor profile","href":"/api-reference/v2/merchant/endpoint/update-vendor-profile"},{"openapi":"openapi-merchant.json GET /vendors/{vendorId}/address","title":"Get vendor address","href":"/api-reference/v2/merchant/endpoint/get-vendor-address"},{"openapi":"openapi-merchant.json PUT /vendors/{vendorId}/address","title":"Update vendor address","href":"/api-reference/v2/merchant/endpoint/update-vendor-address"}]},{"group":"Users","pages":[{"openapi":"openapi-merchant.json GET /users","title":"List users (vendor-scoped)","href":"/api-reference/v2/merchant/endpoint/list-users"},{"openapi":"openapi-merchant.json POST /users","title":"Create user (vendor-scoped)","href":"/api-reference/v2/merchant/endpoint/create-user"},{"openapi":"openapi-merchant.json GET /users/{userId}","title":"Get a single user","href":"/api-reference/v2/merchant/endpoint/get-user"},{"openapi":"openapi-merchant.json PUT /users/{userId}","title":"Update user (vendor-scoped)","href":"/api-reference/v2/merchant/endpoint/update-user"},{"openapi":"openapi-merchant.json DELETE /users/{userId}","title":"Delete user (vendor-scoped)","href":"/api-reference/v2/merchant/endpoint/delete-user"}]},{"group":"Payouts","pages":[{"openapi":"openapi-merchant.json GET /payouts/methods","title":"List payout methods","href":"/api-reference/v2/merchant/endpoint/list-payout-methods"},{"openapi":"openapi-merchant.json GET /payouts/pending","title":"List pending payouts","href":"/api-reference/v2/merchant/endpoint/list-pending-payouts"},{"openapi":"openapi-merchant.json GET /payouts/pending/items/{vendorId}","title":"List a vendor's pending items","href":"/api-reference/v2/merchant/endpoint/list-pending-payout-items"},{"openapi":"openapi-merchant.json POST /payouts/make-payment/dry-run","title":"Preview a payout","href":"/api-reference/v2/merchant/endpoint/dry-run-payout"},{"openapi":"openapi-merchant.json POST /payouts/make-payment","title":"Create a payout","href":"/api-reference/v2/merchant/endpoint/make-payout-payment"},{"openapi":"openapi-merchant.json GET /payouts/make-payment/{transactionId}","title":"Get a payout","href":"/api-reference/v2/merchant/endpoint/get-payout-run"},{"openapi":"openapi-merchant.json POST /payouts/batches/{batchId}/retry","title":"Retry a payout batch","href":"/api-reference/v2/merchant/endpoint/retry-payout-batch"},{"openapi":"openapi-merchant.json POST /payouts/batches/{batchId}/mark-paid","title":"Mark a payout batch as paid","href":"/api-reference/v2/merchant/endpoint/mark-payout-batch-paid"},{"openapi":"openapi-merchant.json GET /payouts/transactions","title":"List payout transactions","href":"/api-reference/v2/merchant/endpoint/list-payout-transactions"}]},{"group":"Payout Adjustments","pages":[{"openapi":"openapi-merchant.json GET /payouts/adjustments","title":"List payout adjustments","href":"/api-reference/v2/merchant/endpoint/list-payout-adjustments"},{"openapi":"openapi-merchant.json POST /payouts/adjustments","title":"Create a payout adjustment","href":"/api-reference/v2/merchant/endpoint/create-payout-adjustment"},{"openapi":"openapi-merchant.json GET /payouts/adjustments/{id}","title":"Get a payout adjustment","href":"/api-reference/v2/merchant/endpoint/get-payout-adjustment"},{"openapi":"openapi-merchant.json PATCH /payouts/adjustments/{id}","title":"Update a payout adjustment","href":"/api-reference/v2/merchant/endpoint/update-payout-adjustment"},{"openapi":"openapi-merchant.json DELETE /payouts/adjustments/{id}","title":"Delete a payout adjustment","href":"/api-reference/v2/merchant/endpoint/delete-payout-adjustment"}]},{"group":"Products","pages":[{"openapi":"openapi-merchant.json GET /products","title":"List products","href":"/api-reference/v2/merchant/endpoint/list-products"},{"openapi":"openapi-merchant.json GET /products/{productId}","title":"Get a product","description":"Get any product in your store, with its variants and Shopify category.","href":"/api-reference/v2/merchant/endpoint/get-product"},{"openapi":"openapi-merchant.json POST /products","title":"Create a product","href":"/api-reference/v2/merchant/endpoint/create-product"},{"openapi":"openapi-merchant.json PUT /products/{productId}","title":"Update a product","description":"Update any product in your store, straight to Shopify. Send `vendorId` to move the product to another vendor. Send the full set of metafields: any left out are deleted. A live product with a vendor edit waiting for review is refused with 409 `PRODUCT_PENDING_REVIEW`; approve or reject the edit first.","href":"/api-reference/v2/merchant/endpoint/update-product"},{"openapi":"openapi-merchant.json DELETE /products/{productId}","title":"Delete a product","href":"/api-reference/v2/merchant/endpoint/delete-product"},{"openapi":"openapi-merchant.json GET /products/counts","title":"Get product counts","href":"/api-reference/v2/merchant/endpoint/get-product-counts"},{"openapi":"openapi-merchant.json PATCH /products/{productId}/status","title":"Update product status","href":"/api-reference/v2/merchant/endpoint/update-product-status"},{"openapi":"openapi-merchant.json POST /products/{productId}/duplicate","title":"Duplicate a product","href":"/api-reference/v2/merchant/endpoint/duplicate-product"},{"openapi":"openapi-merchant.json PATCH /products/{productId}/inventory","title":"Update product inventory","href":"/api-reference/v2/merchant/endpoint/update-product-inventory"},{"openapi":"openapi-merchant.json POST /products/media","title":"Upload product media","href":"/api-reference/v2/merchant/endpoint/upload-product-media"},{"openapi":"openapi-merchant.json POST /products/ai/description","title":"Generate an AI product description","href":"/api-reference/v2/merchant/endpoint/ai-product-description"},{"openapi":"openapi-merchant.json POST /products/barcode","title":"Generate a barcode","href":"/api-reference/v2/merchant/endpoint/generate-barcode"},{"openapi":"openapi-merchant.json POST /products/approve","title":"Approve products","href":"/api-reference/v2/merchant/endpoint/approve-products"},{"openapi":"openapi-merchant.json POST /products/reject","title":"Reject products","href":"/api-reference/v2/merchant/endpoint/reject-products"}]}]}]},"basePath":"","title":"Create a product - PuppetVendors API","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-i2a3QZ8E.js","utils-ChLwp8m0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DRktVTDc.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CA2pEs4T.js","snippetPresets-ClQ6XrKD.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Ct_Lv36y.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Cn2PYw9e.js","shallow-rkyymjXQ.js","getApiPlaygroundDisplay-BB9vkXtE.js","CodeSnippet-Bm5RU7m1.js","CodeSnippets-BgU9Deuz.js","Page-BUDYNlhG.js","getPastedJson-BD-6NNum.js","icon-8Z6tud2e.js","MethodPill-Tuzr4g3V.js","DuplicateIcon-0ceWFYhN.js","createIcon-FBXow_ST.js","DynamicMarkdown-CD8713Yy.js","SectionHeading-7zgzQbH-.js","axios-vUo_bRtp.js","Markdown-D7Ofw1oz.js","clsx-eKJ4rcii.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CwjSCXIK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-9EK5IAXV.js"]}