curl --request POST \
--url https://api.salesive.com/api/v1/products \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Classic Tee",
"description": "Soft cotton t-shirt",
"price": 19.99,
"weight": 0.3,
"category": "66a1f0aae1b3a40012ab1100",
"quantity": 120,
"promoPrice": 14.99,
"images": [
"https://cdn.salesive.com/p/classic-tee.jpg"
],
"featured": true,
"listed": true,
"lowStockAlert": 10,
"barcode": "0123456789012"
}
'import requests
url = "https://api.salesive.com/api/v1/products"
payload = {
"name": "Classic Tee",
"description": "Soft cotton t-shirt",
"price": 19.99,
"weight": 0.3,
"category": "66a1f0aae1b3a40012ab1100",
"quantity": 120,
"promoPrice": 14.99,
"images": ["https://cdn.salesive.com/p/classic-tee.jpg"],
"featured": True,
"listed": True,
"lowStockAlert": 10,
"barcode": "0123456789012"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Classic Tee',
description: 'Soft cotton t-shirt',
price: 19.99,
weight: 0.3,
category: '66a1f0aae1b3a40012ab1100',
quantity: 120,
promoPrice: 14.99,
images: ['https://cdn.salesive.com/p/classic-tee.jpg'],
featured: true,
listed: true,
lowStockAlert: 10,
barcode: '0123456789012'
})
};
fetch('https://api.salesive.com/api/v1/products', 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://api.salesive.com/api/v1/products",
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([
'name' => 'Classic Tee',
'description' => 'Soft cotton t-shirt',
'price' => 19.99,
'weight' => 0.3,
'category' => '66a1f0aae1b3a40012ab1100',
'quantity' => 120,
'promoPrice' => 14.99,
'images' => [
'https://cdn.salesive.com/p/classic-tee.jpg'
],
'featured' => true,
'listed' => true,
'lowStockAlert' => 10,
'barcode' => '0123456789012'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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://api.salesive.com/api/v1/products"
payload := strings.NewReader("{\n \"name\": \"Classic Tee\",\n \"description\": \"Soft cotton t-shirt\",\n \"price\": 19.99,\n \"weight\": 0.3,\n \"category\": \"66a1f0aae1b3a40012ab1100\",\n \"quantity\": 120,\n \"promoPrice\": 14.99,\n \"images\": [\n \"https://cdn.salesive.com/p/classic-tee.jpg\"\n ],\n \"featured\": true,\n \"listed\": true,\n \"lowStockAlert\": 10,\n \"barcode\": \"0123456789012\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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://api.salesive.com/api/v1/products")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Classic Tee\",\n \"description\": \"Soft cotton t-shirt\",\n \"price\": 19.99,\n \"weight\": 0.3,\n \"category\": \"66a1f0aae1b3a40012ab1100\",\n \"quantity\": 120,\n \"promoPrice\": 14.99,\n \"images\": [\n \"https://cdn.salesive.com/p/classic-tee.jpg\"\n ],\n \"featured\": true,\n \"listed\": true,\n \"lowStockAlert\": 10,\n \"barcode\": \"0123456789012\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.salesive.com/api/v1/products")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Classic Tee\",\n \"description\": \"Soft cotton t-shirt\",\n \"price\": 19.99,\n \"weight\": 0.3,\n \"category\": \"66a1f0aae1b3a40012ab1100\",\n \"quantity\": 120,\n \"promoPrice\": 14.99,\n \"images\": [\n \"https://cdn.salesive.com/p/classic-tee.jpg\"\n ],\n \"featured\": true,\n \"listed\": true,\n \"lowStockAlert\": 10,\n \"barcode\": \"0123456789012\"\n}"
response = http.request(request)
puts response.read_body{
"status": 201,
"success": true,
"message": "Create a product",
"data": {
"_id": "66a1f2c4e1b3a40012ab34cd",
"name": "Classic Tee",
"slug": "classic-tee",
"description": "Soft cotton t-shirt",
"price": 19.99,
"promoPrice": 14.99,
"weight": 0.3,
"quantity": 120,
"category": "66a1f0aae1b3a40012ab1100",
"images": [
"https://cdn.salesive.com/p/classic-tee.jpg"
],
"featured": true,
"listed": true,
"hasVariants": false,
"variants": [],
"lowStockAlert": 10,
"barcode": "0123456789012",
"shop": "66a1eee0e1b3a40012ab0001",
"createdAt": "2026-06-28T09:00:00.000Z",
"updatedAt": "2026-06-28T09:00:00.000Z"
}
}{
"status": 401,
"success": false,
"message": "Unauthorized",
"data": {}
}{
"status": 403,
"success": false,
"message": "Forbidden: missing required scope",
"data": {}
}Create a product
Creates a product in the store.
curl --request POST \
--url https://api.salesive.com/api/v1/products \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Classic Tee",
"description": "Soft cotton t-shirt",
"price": 19.99,
"weight": 0.3,
"category": "66a1f0aae1b3a40012ab1100",
"quantity": 120,
"promoPrice": 14.99,
"images": [
"https://cdn.salesive.com/p/classic-tee.jpg"
],
"featured": true,
"listed": true,
"lowStockAlert": 10,
"barcode": "0123456789012"
}
'import requests
url = "https://api.salesive.com/api/v1/products"
payload = {
"name": "Classic Tee",
"description": "Soft cotton t-shirt",
"price": 19.99,
"weight": 0.3,
"category": "66a1f0aae1b3a40012ab1100",
"quantity": 120,
"promoPrice": 14.99,
"images": ["https://cdn.salesive.com/p/classic-tee.jpg"],
"featured": True,
"listed": True,
"lowStockAlert": 10,
"barcode": "0123456789012"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Classic Tee',
description: 'Soft cotton t-shirt',
price: 19.99,
weight: 0.3,
category: '66a1f0aae1b3a40012ab1100',
quantity: 120,
promoPrice: 14.99,
images: ['https://cdn.salesive.com/p/classic-tee.jpg'],
featured: true,
listed: true,
lowStockAlert: 10,
barcode: '0123456789012'
})
};
fetch('https://api.salesive.com/api/v1/products', 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://api.salesive.com/api/v1/products",
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([
'name' => 'Classic Tee',
'description' => 'Soft cotton t-shirt',
'price' => 19.99,
'weight' => 0.3,
'category' => '66a1f0aae1b3a40012ab1100',
'quantity' => 120,
'promoPrice' => 14.99,
'images' => [
'https://cdn.salesive.com/p/classic-tee.jpg'
],
'featured' => true,
'listed' => true,
'lowStockAlert' => 10,
'barcode' => '0123456789012'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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://api.salesive.com/api/v1/products"
payload := strings.NewReader("{\n \"name\": \"Classic Tee\",\n \"description\": \"Soft cotton t-shirt\",\n \"price\": 19.99,\n \"weight\": 0.3,\n \"category\": \"66a1f0aae1b3a40012ab1100\",\n \"quantity\": 120,\n \"promoPrice\": 14.99,\n \"images\": [\n \"https://cdn.salesive.com/p/classic-tee.jpg\"\n ],\n \"featured\": true,\n \"listed\": true,\n \"lowStockAlert\": 10,\n \"barcode\": \"0123456789012\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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://api.salesive.com/api/v1/products")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Classic Tee\",\n \"description\": \"Soft cotton t-shirt\",\n \"price\": 19.99,\n \"weight\": 0.3,\n \"category\": \"66a1f0aae1b3a40012ab1100\",\n \"quantity\": 120,\n \"promoPrice\": 14.99,\n \"images\": [\n \"https://cdn.salesive.com/p/classic-tee.jpg\"\n ],\n \"featured\": true,\n \"listed\": true,\n \"lowStockAlert\": 10,\n \"barcode\": \"0123456789012\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.salesive.com/api/v1/products")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Classic Tee\",\n \"description\": \"Soft cotton t-shirt\",\n \"price\": 19.99,\n \"weight\": 0.3,\n \"category\": \"66a1f0aae1b3a40012ab1100\",\n \"quantity\": 120,\n \"promoPrice\": 14.99,\n \"images\": [\n \"https://cdn.salesive.com/p/classic-tee.jpg\"\n ],\n \"featured\": true,\n \"listed\": true,\n \"lowStockAlert\": 10,\n \"barcode\": \"0123456789012\"\n}"
response = http.request(request)
puts response.read_body{
"status": 201,
"success": true,
"message": "Create a product",
"data": {
"_id": "66a1f2c4e1b3a40012ab34cd",
"name": "Classic Tee",
"slug": "classic-tee",
"description": "Soft cotton t-shirt",
"price": 19.99,
"promoPrice": 14.99,
"weight": 0.3,
"quantity": 120,
"category": "66a1f0aae1b3a40012ab1100",
"images": [
"https://cdn.salesive.com/p/classic-tee.jpg"
],
"featured": true,
"listed": true,
"hasVariants": false,
"variants": [],
"lowStockAlert": 10,
"barcode": "0123456789012",
"shop": "66a1eee0e1b3a40012ab0001",
"createdAt": "2026-06-28T09:00:00.000Z",
"updatedAt": "2026-06-28T09:00:00.000Z"
}
}{
"status": 401,
"success": false,
"message": "Unauthorized",
"data": {}
}{
"status": 403,
"success": false,
"message": "Forbidden: missing required scope",
"data": {}
}shop and owning user are set server-side from the installation and must not be supplied. Requires the WRITE_INVENTORY scope.Authorizations
Installed-app access token (prefix app_), issued by the OAuth install flow. The store is bound to the token server-side — never send a shop id.
Body
Product name.
Product description.
Base price (>= 0).
Weight (>= 0).
Category ObjectId.
Stock quantity (>= 0).
Sale/promotional price (>= 0); nullable.
Array of image URLs.
Video URL; nullable.
Whether the product is featured. Default false.
Whether the product is listed in the storefront. Default true.
Product variants. Each: attributes (object of string->string, required), price (number, required), promoPrice (number, nullable), quantity (integer), weight (number), sku (string).
Show child attributes
Show child attributes
Threshold at which the product is flagged low-stock (>= 0).
Product barcode; nullable.
Response
Create a product — success.
201
true
"Create a product"
An ecommerce catalog product.
Show child attributes
Show child attributes
{
"_id": "66a1f2c4e1b3a40012ab34cd",
"name": "Classic Tee",
"slug": "classic-tee",
"description": "Soft cotton t-shirt",
"price": 19.99,
"promoPrice": 14.99,
"weight": 0.3,
"quantity": 120,
"category": "66a1f0aae1b3a40012ab1100",
"images": [
"https://cdn.salesive.com/p/classic-tee.jpg"
],
"featured": true,
"listed": true,
"hasVariants": false,
"variants": [],
"lowStockAlert": 10,
"barcode": "0123456789012",
"shop": "66a1eee0e1b3a40012ab0001",
"createdAt": "2026-06-28T09:00:00.000Z",
"updatedAt": "2026-06-28T09:00:00.000Z"
}
Was this page helpful?

