Create Product

curl --request POST \
  --url https://production-api.puppetvendors.com/products/create \
  --header 'Content-Type: application/json' \
  --header 'x-access-token: <api-key>' \
  --data '
{
  "title": "<string>",
  "descriptionHtml": "<string>",
  "productType": "<string>",
  "status": "<string>",
  "handle": "<string>",
  "tags": [
    "<string>"
  ],
  "options": [
    {}
  ],
  "variants": [
    {}
  ],
  "metafields": [
    {}
  ],
  "media": [
    {}
  ],
  "seo": {},
  "category": "<string>",
  "templateSuffix": "<string>",
  "published": true
}
'

import requests

url = "https://production-api.puppetvendors.com/products/create"

payload = {
    "title": "<string>",
    "descriptionHtml": "<string>",
    "productType": "<string>",
    "status": "<string>",
    "handle": "<string>",
    "tags": ["<string>"],
    "options": [{}],
    "variants": [{}],
    "metafields": [{}],
    "media": [{}],
    "seo": {},
    "category": "<string>",
    "templateSuffix": "<string>",
    "published": True
}
headers = {
    "x-access-token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-access-token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    title: '<string>',
    descriptionHtml: '<string>',
    productType: '<string>',
    status: '<string>',
    handle: '<string>',
    tags: ['<string>'],
    options: [{}],
    variants: [{}],
    metafields: [{}],
    media: [{}],
    seo: {},
    category: '<string>',
    templateSuffix: '<string>',
    published: true
  })
};

fetch('https://production-api.puppetvendors.com/products/create', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://production-api.puppetvendors.com/products/create",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => '<string>',
    'descriptionHtml' => '<string>',
    'productType' => '<string>',
    'status' => '<string>',
    'handle' => '<string>',
    'tags' => [
        '<string>'
    ],
    'options' => [
        [
                
        ]
    ],
    'variants' => [
        [
                
        ]
    ],
    'metafields' => [
        [
                
        ]
    ],
    'media' => [
        [
                
        ]
    ],
    'seo' => [
        
    ],
    'category' => '<string>',
    'templateSuffix' => '<string>',
    'published' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-access-token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://production-api.puppetvendors.com/products/create"

	payload := strings.NewReader("{\n  \"title\": \"<string>\",\n  \"descriptionHtml\": \"<string>\",\n  \"productType\": \"<string>\",\n  \"status\": \"<string>\",\n  \"handle\": \"<string>\",\n  \"tags\": [\n    \"<string>\"\n  ],\n  \"options\": [\n    {}\n  ],\n  \"variants\": [\n    {}\n  ],\n  \"metafields\": [\n    {}\n  ],\n  \"media\": [\n    {}\n  ],\n  \"seo\": {},\n  \"category\": \"<string>\",\n  \"templateSuffix\": \"<string>\",\n  \"published\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-access-token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://production-api.puppetvendors.com/products/create")
  .header("x-access-token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"title\": \"<string>\",\n  \"descriptionHtml\": \"<string>\",\n  \"productType\": \"<string>\",\n  \"status\": \"<string>\",\n  \"handle\": \"<string>\",\n  \"tags\": [\n    \"<string>\"\n  ],\n  \"options\": [\n    {}\n  ],\n  \"variants\": [\n    {}\n  ],\n  \"metafields\": [\n    {}\n  ],\n  \"media\": [\n    {}\n  ],\n  \"seo\": {},\n  \"category\": \"<string>\",\n  \"templateSuffix\": \"<string>\",\n  \"published\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://production-api.puppetvendors.com/products/create")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-access-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"title\": \"<string>\",\n  \"descriptionHtml\": \"<string>\",\n  \"productType\": \"<string>\",\n  \"status\": \"<string>\",\n  \"handle\": \"<string>\",\n  \"tags\": [\n    \"<string>\"\n  ],\n  \"options\": [\n    {}\n  ],\n  \"variants\": [\n    {}\n  ],\n  \"metafields\": [\n    {}\n  ],\n  \"media\": [\n    {}\n  ],\n  \"seo\": {},\n  \"category\": \"<string>\",\n  \"templateSuffix\": \"<string>\",\n  \"published\": true\n}"

response = http.request(request)
puts response.read_body

POST

products

create

Create Product

curl --request POST \
  --url https://production-api.puppetvendors.com/products/create \
  --header 'Content-Type: application/json' \
  --header 'x-access-token: <api-key>' \
  --data '
{
  "title": "<string>",
  "descriptionHtml": "<string>",
  "productType": "<string>",
  "status": "<string>",
  "handle": "<string>",
  "tags": [
    "<string>"
  ],
  "options": [
    {}
  ],
  "variants": [
    {}
  ],
  "metafields": [
    {}
  ],
  "media": [
    {}
  ],
  "seo": {},
  "category": "<string>",
  "templateSuffix": "<string>",
  "published": true
}
'

import requests

url = "https://production-api.puppetvendors.com/products/create"

payload = {
    "title": "<string>",
    "descriptionHtml": "<string>",
    "productType": "<string>",
    "status": "<string>",
    "handle": "<string>",
    "tags": ["<string>"],
    "options": [{}],
    "variants": [{}],
    "metafields": [{}],
    "media": [{}],
    "seo": {},
    "category": "<string>",
    "templateSuffix": "<string>",
    "published": True
}
headers = {
    "x-access-token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-access-token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    title: '<string>',
    descriptionHtml: '<string>',
    productType: '<string>',
    status: '<string>',
    handle: '<string>',
    tags: ['<string>'],
    options: [{}],
    variants: [{}],
    metafields: [{}],
    media: [{}],
    seo: {},
    category: '<string>',
    templateSuffix: '<string>',
    published: true
  })
};

fetch('https://production-api.puppetvendors.com/products/create', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://production-api.puppetvendors.com/products/create",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => '<string>',
    'descriptionHtml' => '<string>',
    'productType' => '<string>',
    'status' => '<string>',
    'handle' => '<string>',
    'tags' => [
        '<string>'
    ],
    'options' => [
        [
                
        ]
    ],
    'variants' => [
        [
                
        ]
    ],
    'metafields' => [
        [
                
        ]
    ],
    'media' => [
        [
                
        ]
    ],
    'seo' => [
        
    ],
    'category' => '<string>',
    'templateSuffix' => '<string>',
    'published' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-access-token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://production-api.puppetvendors.com/products/create"

	payload := strings.NewReader("{\n  \"title\": \"<string>\",\n  \"descriptionHtml\": \"<string>\",\n  \"productType\": \"<string>\",\n  \"status\": \"<string>\",\n  \"handle\": \"<string>\",\n  \"tags\": [\n    \"<string>\"\n  ],\n  \"options\": [\n    {}\n  ],\n  \"variants\": [\n    {}\n  ],\n  \"metafields\": [\n    {}\n  ],\n  \"media\": [\n    {}\n  ],\n  \"seo\": {},\n  \"category\": \"<string>\",\n  \"templateSuffix\": \"<string>\",\n  \"published\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-access-token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://production-api.puppetvendors.com/products/create")
  .header("x-access-token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"title\": \"<string>\",\n  \"descriptionHtml\": \"<string>\",\n  \"productType\": \"<string>\",\n  \"status\": \"<string>\",\n  \"handle\": \"<string>\",\n  \"tags\": [\n    \"<string>\"\n  ],\n  \"options\": [\n    {}\n  ],\n  \"variants\": [\n    {}\n  ],\n  \"metafields\": [\n    {}\n  ],\n  \"media\": [\n    {}\n  ],\n  \"seo\": {},\n  \"category\": \"<string>\",\n  \"templateSuffix\": \"<string>\",\n  \"published\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://production-api.puppetvendors.com/products/create")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-access-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"title\": \"<string>\",\n  \"descriptionHtml\": \"<string>\",\n  \"productType\": \"<string>\",\n  \"status\": \"<string>\",\n  \"handle\": \"<string>\",\n  \"tags\": [\n    \"<string>\"\n  ],\n  \"options\": [\n    {}\n  ],\n  \"variants\": [\n    {}\n  ],\n  \"metafields\": [\n    {}\n  ],\n  \"media\": [\n    {}\n  ],\n  \"seo\": {},\n  \"category\": \"<string>\",\n  \"templateSuffix\": \"<string>\",\n  \"published\": true\n}"

response = http.request(request)
puts response.read_body

V2 Alpha — This endpoint is part of the V2 API preview. Breaking changes may occur.

Overview

Create a new product via Shopify’s productSet mutation on behalf of the authenticated vendor. Includes variants, options, metafields, and media in a single synchronous call. Maximum 100 variants per product. The vendor ID is derived from the JWT token and does not need to be sent in the request body.

Vendor Token Required — This endpoint requires a vendor-scoped JWT token. Merchant tokens will receive a 403 error.

Use Cases

Vendor product submission — Let vendors create products directly via API
Automated product imports — Import products from external catalogues
Headless product management — Build custom vendor product creation flows

Request Body

string

required

Product title (max 255 characters).

string

HTML product description.

string

Product type (max 255 characters).

string

default:"DRAFT"

Initial product status. One of: ACTIVE, DRAFT, ARCHIVED.

string

URL handle (max 255 characters). Auto-generated from title if not provided.

string[]

Product tags (max 250 tags).

object[]

Product options (max 3). Each option has name (string) and values (string array).

object[]

Product variants (max 100). Each variant can include:

optionValues — Array of { name, value } matching product options
price — Decimal string (e.g. "29.99")
sku — SKU string
barcode — Barcode string
inventoryQuantity — Integer
weight — Object with value (number) and optional unit (POUNDS, OUNCES, KILOGRAMS, GRAMS)

object[]

Product metafields. Each has namespace, key, value, and optional type.

object[]

Product media (max 250). Each has originalSource (URL), optional mediaContentType (IMAGE, VIDEO, MODEL_3D, EXTERNAL_VIDEO), and optional alt.

object

SEO settings with optional title (max 255) and description (max 320).

string

Product category.

string

Shopify template suffix for this product.

boolean

Whether the product should be published to the online store.

Response

201

{
  "success": true,
  "data": {
    "_id": "507f1f77bcf86cd799439035",
    "title": "Widget Pro",
    "handle": "widget-pro",
    "status": "DRAFT",
    "productId": 7654321098765,
    "graphqlProductId": "gid://shopify/Product/7654321098765",
    "createdAt": "2024-06-15T10:30:00.000Z"
  }
}

Error Responses

400

{
  "success": false,
  "error": {
    "message": "Title is required",
    "code": "VALIDATION_ERROR"
  }
}

Example

curl -X POST https://production-api.puppetvendors.com/products/create \
  -H "Content-Type: application/json" \
  -H "x-access-token: YOUR_VENDOR_JWT_TOKEN" \
  -d '{
    "title": "Widget Pro",
    "descriptionHtml": "<p>Premium widget for all occasions</p>",
    "status": "DRAFT",
    "options": [
      { "name": "Size", "values": ["Small", "Medium", "Large"] }
    ],
    "variants": [
      {
        "optionValues": [{ "name": "Size", "value": "Small" }],
        "price": "19.99",
        "sku": "WP-SM"
      },
      {
        "optionValues": [{ "name": "Size", "value": "Medium" }],
        "price": "24.99",
        "sku": "WP-MD"
      },
      {
        "optionValues": [{ "name": "Size", "value": "Large" }],
        "price": "29.99",
        "sku": "WP-LG"
      }
    ],
    "tags": ["widget", "premium"],
    "seo": {
      "title": "Widget Pro - Premium Widget",
      "description": "The best widget for your needs"
    }
  }'

More Examples

Create a simple product (no variants)

curl -X POST https://production-api.puppetvendors.com/products/create \
  -H "Content-Type: application/json" \
  -H "x-access-token: YOUR_VENDOR_JWT_TOKEN" \
  -d '{
    "title": "Gift Card",
    "productType": "Gift Cards",
    "status": "ACTIVE",
    "tags": ["gift"]
  }'

Create a digital product

curl -X POST https://production-api.puppetvendors.com/products/create \
  -H "Content-Type: application/json" \
  -H "x-access-token: YOUR_VENDOR_JWT_TOKEN" \
  -d '{
    "title": "Photography Preset Pack",
    "isDigital": true,
    "status": "DRAFT",
    "variants": [
      {
        "title": "Standard Pack",
        "price": "19.99",
        "sku": "PRESET-STD"
      }
    ]
  }'

Getting Started

Authentication

Vendor Portal Auth

Orders

Products

Fulfillments

Fulfillment Events

Documents

Payouts

Customers

Discounts

Shipping Operations

Vendor Profile

Account Settings

Shipping Settings

Team Members

Users

Integrations

Create Product

Overview

Use Cases

Request Body

Response

Error Responses

Example

More Examples

​Overview

​Use Cases

​Request Body

​Response

​Error Responses

​Example

​More Examples

Overview

Use Cases

Request Body

Response

Error Responses

Example

More Examples