Skip to main content
POST
Create Product
V2 Alpha: this endpoint is part of the V2 API preview. Breaking changes may occur.

Overview

POST /products
POST /products/create is deprecated. It still works and takes the same body, but every response carries Deprecation: true and Link: </products>; rel="successor-version". Move to POST /products.
Creates a product via Shopify’s productSet mutation on behalf of the authenticated vendor, with variants, options, metafields and images in one synchronous call. Max 100 variants. Your vendor id comes from the token; don’t send vendorId.
Vendor token required. Use a token minted from a vendor key (vk_live_…) or a portal login.

Request body

title string required. Max 255 characters. descriptionHtml string. HTML description. productType string. Max 255. status string, default DRAFT. ACTIVE or DRAFT. Controls storefront visibility; there is no published field. handle string. Max 255; generated from the title if omitted. tags string[]. Max 250. collections string[]. Max 250. options object[]. Max 3; each { name, values[] }. variants object[] required. 1 to 100 variants. Each needs price (decimal string, e.g. "1.00"). Each may also include optionValues ([{ name, value }]), sku, barcode, inventoryQuantity, weight ({ value, unit }). metafields object[]. { namespace, key, value, type? }. images object[]. Max 250; { src, altText? }. medias object[]. Max 250; downloadable files for digital products. isDigital boolean. seo object (title ≤255, description ≤320). category, templateSuffix string. The body is strict: unknown fields return 400 VALIDATION_ERROR with a hint (published → status, media → images/medias, description → descriptionHtml).

Responses

If your shop requires product approval, a new product comes back with status: "pending" and no Shopify ids. They appear after a merchant approves it.
201 Created
400 Missing
400 Unsupported field
Deprecated path response headers

Example

Digital product