Bulk Upsert Products
curl --request POST \
--url https://api.wizcommerce.com/v1/products/bulk \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"data": [
{
"sku_id": "CUSH-RED-18",
"name": "Velvet Cushion Red 18in",
"id": "01f5d171-d3e3-4b2b-bd57-0727194b5bed",
"reference_id": "CUSH-RED-18",
"group_code": "CUSH-VELVET-18",
"keep_existing_group": false,
"is_primary": true,
"priority": 1,
"status": "active",
"brand": "Auralane",
"grouping_attributes": [
"Color",
"Size"
],
"attributes": [
{
"id": "3f1c2b9e-7a1d-4c55-9a0e-2f8d6b1c4e21",
"name": "Color",
"value": "<unknown>"
}
],
"hinge_values": {},
"categories": [
"Home Decor/Cushions"
],
"collections": [
"Winter 2026"
],
"tags": [
"velvet",
"bestseller"
],
"product_prices": [
{
"price": 24.99,
"price_list_id": "9c8b7a6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
"reference_id": "WHOLESALE",
"sale_price": 19.99,
"min_order_quantity": 1,
"step_increment": 1,
"max_order_quantity": 99999,
"default_order_quantity": 6,
"volume_tiers": [
{
"start_quantity": 12,
"price": 21.99,
"step_increment": 1
}
]
}
],
"medias": [
{
"url": "https://cdn.example.com/cushion-red.jpg",
"type": "image",
"order": 1,
"is_default": true
}
],
"url_slug": "velvet-cushion-red-18",
"seo_info": {
"primary_title": "Velvet Cushion",
"title": "Velvet Cushion Red 18in | Auralane",
"description": "Soft velvet cushion cover with insert.",
"keywords": [
"cushion",
"velvet"
]
},
"channel_visibility": {
"website": "ShowForLoggedInUsersOnly"
},
"volume": {
"cbm": 0.02,
"cft": 0.7
}
}
]
}
'import requests
url = "https://api.wizcommerce.com/v1/products/bulk"
payload = { "data": [
{
"sku_id": "CUSH-RED-18",
"name": "Velvet Cushion Red 18in",
"id": "01f5d171-d3e3-4b2b-bd57-0727194b5bed",
"reference_id": "CUSH-RED-18",
"group_code": "CUSH-VELVET-18",
"keep_existing_group": False,
"is_primary": True,
"priority": 1,
"status": "active",
"brand": "Auralane",
"grouping_attributes": ["Color", "Size"],
"attributes": [
{
"id": "3f1c2b9e-7a1d-4c55-9a0e-2f8d6b1c4e21",
"name": "Color",
"value": "<unknown>"
}
],
"hinge_values": {},
"categories": ["Home Decor/Cushions"],
"collections": ["Winter 2026"],
"tags": ["velvet", "bestseller"],
"product_prices": [
{
"price": 24.99,
"price_list_id": "9c8b7a6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
"reference_id": "WHOLESALE",
"sale_price": 19.99,
"min_order_quantity": 1,
"step_increment": 1,
"max_order_quantity": 99999,
"default_order_quantity": 6,
"volume_tiers": [
{
"start_quantity": 12,
"price": 21.99,
"step_increment": 1
}
]
}
],
"medias": [
{
"url": "https://cdn.example.com/cushion-red.jpg",
"type": "image",
"order": 1,
"is_default": True
}
],
"url_slug": "velvet-cushion-red-18",
"seo_info": {
"primary_title": "Velvet Cushion",
"title": "Velvet Cushion Red 18in | Auralane",
"description": "Soft velvet cushion cover with insert.",
"keywords": ["cushion", "velvet"]
},
"channel_visibility": { "website": "ShowForLoggedInUsersOnly" },
"volume": {
"cbm": 0.02,
"cft": 0.7
}
}
] }
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
data: [
{
sku_id: 'CUSH-RED-18',
name: 'Velvet Cushion Red 18in',
id: '01f5d171-d3e3-4b2b-bd57-0727194b5bed',
reference_id: 'CUSH-RED-18',
group_code: 'CUSH-VELVET-18',
keep_existing_group: false,
is_primary: true,
priority: 1,
status: 'active',
brand: 'Auralane',
grouping_attributes: ['Color', 'Size'],
attributes: [
{id: '3f1c2b9e-7a1d-4c55-9a0e-2f8d6b1c4e21', name: 'Color', value: '<unknown>'}
],
hinge_values: {},
categories: ['Home Decor/Cushions'],
collections: ['Winter 2026'],
tags: ['velvet', 'bestseller'],
product_prices: [
{
price: 24.99,
price_list_id: '9c8b7a6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d',
reference_id: 'WHOLESALE',
sale_price: 19.99,
min_order_quantity: 1,
step_increment: 1,
max_order_quantity: 99999,
default_order_quantity: 6,
volume_tiers: [{start_quantity: 12, price: 21.99, step_increment: 1}]
}
],
medias: [
{
url: 'https://cdn.example.com/cushion-red.jpg',
type: 'image',
order: 1,
is_default: true
}
],
url_slug: 'velvet-cushion-red-18',
seo_info: {
primary_title: 'Velvet Cushion',
title: 'Velvet Cushion Red 18in | Auralane',
description: 'Soft velvet cushion cover with insert.',
keywords: ['cushion', 'velvet']
},
channel_visibility: {website: 'ShowForLoggedInUsersOnly'},
volume: {cbm: 0.02, cft: 0.7}
}
]
})
};
fetch('https://api.wizcommerce.com/v1/products/bulk', 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.wizcommerce.com/v1/products/bulk",
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([
'data' => [
[
'sku_id' => 'CUSH-RED-18',
'name' => 'Velvet Cushion Red 18in',
'id' => '01f5d171-d3e3-4b2b-bd57-0727194b5bed',
'reference_id' => 'CUSH-RED-18',
'group_code' => 'CUSH-VELVET-18',
'keep_existing_group' => false,
'is_primary' => true,
'priority' => 1,
'status' => 'active',
'brand' => 'Auralane',
'grouping_attributes' => [
'Color',
'Size'
],
'attributes' => [
[
'id' => '3f1c2b9e-7a1d-4c55-9a0e-2f8d6b1c4e21',
'name' => 'Color',
'value' => '<unknown>'
]
],
'hinge_values' => [
],
'categories' => [
'Home Decor/Cushions'
],
'collections' => [
'Winter 2026'
],
'tags' => [
'velvet',
'bestseller'
],
'product_prices' => [
[
'price' => 24.99,
'price_list_id' => '9c8b7a6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d',
'reference_id' => 'WHOLESALE',
'sale_price' => 19.99,
'min_order_quantity' => 1,
'step_increment' => 1,
'max_order_quantity' => 99999,
'default_order_quantity' => 6,
'volume_tiers' => [
[
'start_quantity' => 12,
'price' => 21.99,
'step_increment' => 1
]
]
]
],
'medias' => [
[
'url' => 'https://cdn.example.com/cushion-red.jpg',
'type' => 'image',
'order' => 1,
'is_default' => true
]
],
'url_slug' => 'velvet-cushion-red-18',
'seo_info' => [
'primary_title' => 'Velvet Cushion',
'title' => 'Velvet Cushion Red 18in | Auralane',
'description' => 'Soft velvet cushion cover with insert.',
'keywords' => [
'cushion',
'velvet'
]
],
'channel_visibility' => [
'website' => 'ShowForLoggedInUsersOnly'
],
'volume' => [
'cbm' => 0.02,
'cft' => 0.7
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <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://api.wizcommerce.com/v1/products/bulk"
payload := strings.NewReader("{\n \"data\": [\n {\n \"sku_id\": \"CUSH-RED-18\",\n \"name\": \"Velvet Cushion Red 18in\",\n \"id\": \"01f5d171-d3e3-4b2b-bd57-0727194b5bed\",\n \"reference_id\": \"CUSH-RED-18\",\n \"group_code\": \"CUSH-VELVET-18\",\n \"keep_existing_group\": false,\n \"is_primary\": true,\n \"priority\": 1,\n \"status\": \"active\",\n \"brand\": \"Auralane\",\n \"grouping_attributes\": [\n \"Color\",\n \"Size\"\n ],\n \"attributes\": [\n {\n \"id\": \"3f1c2b9e-7a1d-4c55-9a0e-2f8d6b1c4e21\",\n \"name\": \"Color\",\n \"value\": \"<unknown>\"\n }\n ],\n \"hinge_values\": {},\n \"categories\": [\n \"Home Decor/Cushions\"\n ],\n \"collections\": [\n \"Winter 2026\"\n ],\n \"tags\": [\n \"velvet\",\n \"bestseller\"\n ],\n \"product_prices\": [\n {\n \"price\": 24.99,\n \"price_list_id\": \"9c8b7a6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d\",\n \"reference_id\": \"WHOLESALE\",\n \"sale_price\": 19.99,\n \"min_order_quantity\": 1,\n \"step_increment\": 1,\n \"max_order_quantity\": 99999,\n \"default_order_quantity\": 6,\n \"volume_tiers\": [\n {\n \"start_quantity\": 12,\n \"price\": 21.99,\n \"step_increment\": 1\n }\n ]\n }\n ],\n \"medias\": [\n {\n \"url\": \"https://cdn.example.com/cushion-red.jpg\",\n \"type\": \"image\",\n \"order\": 1,\n \"is_default\": true\n }\n ],\n \"url_slug\": \"velvet-cushion-red-18\",\n \"seo_info\": {\n \"primary_title\": \"Velvet Cushion\",\n \"title\": \"Velvet Cushion Red 18in | Auralane\",\n \"description\": \"Soft velvet cushion cover with insert.\",\n \"keywords\": [\n \"cushion\",\n \"velvet\"\n ]\n },\n \"channel_visibility\": {\n \"website\": \"ShowForLoggedInUsersOnly\"\n },\n \"volume\": {\n \"cbm\": 0.02,\n \"cft\": 0.7\n }\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<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://api.wizcommerce.com/v1/products/bulk")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"data\": [\n {\n \"sku_id\": \"CUSH-RED-18\",\n \"name\": \"Velvet Cushion Red 18in\",\n \"id\": \"01f5d171-d3e3-4b2b-bd57-0727194b5bed\",\n \"reference_id\": \"CUSH-RED-18\",\n \"group_code\": \"CUSH-VELVET-18\",\n \"keep_existing_group\": false,\n \"is_primary\": true,\n \"priority\": 1,\n \"status\": \"active\",\n \"brand\": \"Auralane\",\n \"grouping_attributes\": [\n \"Color\",\n \"Size\"\n ],\n \"attributes\": [\n {\n \"id\": \"3f1c2b9e-7a1d-4c55-9a0e-2f8d6b1c4e21\",\n \"name\": \"Color\",\n \"value\": \"<unknown>\"\n }\n ],\n \"hinge_values\": {},\n \"categories\": [\n \"Home Decor/Cushions\"\n ],\n \"collections\": [\n \"Winter 2026\"\n ],\n \"tags\": [\n \"velvet\",\n \"bestseller\"\n ],\n \"product_prices\": [\n {\n \"price\": 24.99,\n \"price_list_id\": \"9c8b7a6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d\",\n \"reference_id\": \"WHOLESALE\",\n \"sale_price\": 19.99,\n \"min_order_quantity\": 1,\n \"step_increment\": 1,\n \"max_order_quantity\": 99999,\n \"default_order_quantity\": 6,\n \"volume_tiers\": [\n {\n \"start_quantity\": 12,\n \"price\": 21.99,\n \"step_increment\": 1\n }\n ]\n }\n ],\n \"medias\": [\n {\n \"url\": \"https://cdn.example.com/cushion-red.jpg\",\n \"type\": \"image\",\n \"order\": 1,\n \"is_default\": true\n }\n ],\n \"url_slug\": \"velvet-cushion-red-18\",\n \"seo_info\": {\n \"primary_title\": \"Velvet Cushion\",\n \"title\": \"Velvet Cushion Red 18in | Auralane\",\n \"description\": \"Soft velvet cushion cover with insert.\",\n \"keywords\": [\n \"cushion\",\n \"velvet\"\n ]\n },\n \"channel_visibility\": {\n \"website\": \"ShowForLoggedInUsersOnly\"\n },\n \"volume\": {\n \"cbm\": 0.02,\n \"cft\": 0.7\n }\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.wizcommerce.com/v1/products/bulk")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"data\": [\n {\n \"sku_id\": \"CUSH-RED-18\",\n \"name\": \"Velvet Cushion Red 18in\",\n \"id\": \"01f5d171-d3e3-4b2b-bd57-0727194b5bed\",\n \"reference_id\": \"CUSH-RED-18\",\n \"group_code\": \"CUSH-VELVET-18\",\n \"keep_existing_group\": false,\n \"is_primary\": true,\n \"priority\": 1,\n \"status\": \"active\",\n \"brand\": \"Auralane\",\n \"grouping_attributes\": [\n \"Color\",\n \"Size\"\n ],\n \"attributes\": [\n {\n \"id\": \"3f1c2b9e-7a1d-4c55-9a0e-2f8d6b1c4e21\",\n \"name\": \"Color\",\n \"value\": \"<unknown>\"\n }\n ],\n \"hinge_values\": {},\n \"categories\": [\n \"Home Decor/Cushions\"\n ],\n \"collections\": [\n \"Winter 2026\"\n ],\n \"tags\": [\n \"velvet\",\n \"bestseller\"\n ],\n \"product_prices\": [\n {\n \"price\": 24.99,\n \"price_list_id\": \"9c8b7a6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d\",\n \"reference_id\": \"WHOLESALE\",\n \"sale_price\": 19.99,\n \"min_order_quantity\": 1,\n \"step_increment\": 1,\n \"max_order_quantity\": 99999,\n \"default_order_quantity\": 6,\n \"volume_tiers\": [\n {\n \"start_quantity\": 12,\n \"price\": 21.99,\n \"step_increment\": 1\n }\n ]\n }\n ],\n \"medias\": [\n {\n \"url\": \"https://cdn.example.com/cushion-red.jpg\",\n \"type\": \"image\",\n \"order\": 1,\n \"is_default\": true\n }\n ],\n \"url_slug\": \"velvet-cushion-red-18\",\n \"seo_info\": {\n \"primary_title\": \"Velvet Cushion\",\n \"title\": \"Velvet Cushion Red 18in | Auralane\",\n \"description\": \"Soft velvet cushion cover with insert.\",\n \"keywords\": [\n \"cushion\",\n \"velvet\"\n ]\n },\n \"channel_visibility\": {\n \"website\": \"ShowForLoggedInUsersOnly\"\n },\n \"volume\": {\n \"cbm\": 0.02,\n \"cft\": 0.7\n }\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": [
{
"index": 0,
"status": "success",
"id": "01f5d171-d3e3-4b2b-bd57-0727194b5bed",
"parent_id": "8e7d6c5b-4a39-4b2c-a1d0-f9e8d7c6b5a4",
"reference_id": "CUSH-RED-18",
"sku_id": "CUSH-RED-18",
"group_code": "CUSH-VELVET-18",
"action": "create",
"indexed": true,
"error": {
"code": "NOT_FOUND",
"message": "Category 'Bedding/Cushions' not found"
},
"mapping_errors": {}
}
],
"meta": {
"total": 2,
"success": 2,
"failed": 0
}
}{
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"reason": "<string>"
}
]
}{
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"reason": "<string>"
}
]
}{
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"reason": "<string>"
}
]
}{
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"reason": "<string>"
}
]
}{
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"reason": "<string>"
}
]
}{
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"reason": "<string>"
}
]
}{
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"reason": "<string>"
}
]
}{
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"reason": "<string>"
}
]
}Product (v2)
Bulk Upsert Products
Creates or updates up to 100 flat product variants in one call. A variant is matched by id or reference_id (reference_id defaults to sku_id). Variants sharing a group_code form one product family. Returns 200 with one result per item (status success/error) and meta totals; check each item’s status.
POST
/
v1
/
products
/
bulk
Bulk Upsert Products
curl --request POST \
--url https://api.wizcommerce.com/v1/products/bulk \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"data": [
{
"sku_id": "CUSH-RED-18",
"name": "Velvet Cushion Red 18in",
"id": "01f5d171-d3e3-4b2b-bd57-0727194b5bed",
"reference_id": "CUSH-RED-18",
"group_code": "CUSH-VELVET-18",
"keep_existing_group": false,
"is_primary": true,
"priority": 1,
"status": "active",
"brand": "Auralane",
"grouping_attributes": [
"Color",
"Size"
],
"attributes": [
{
"id": "3f1c2b9e-7a1d-4c55-9a0e-2f8d6b1c4e21",
"name": "Color",
"value": "<unknown>"
}
],
"hinge_values": {},
"categories": [
"Home Decor/Cushions"
],
"collections": [
"Winter 2026"
],
"tags": [
"velvet",
"bestseller"
],
"product_prices": [
{
"price": 24.99,
"price_list_id": "9c8b7a6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
"reference_id": "WHOLESALE",
"sale_price": 19.99,
"min_order_quantity": 1,
"step_increment": 1,
"max_order_quantity": 99999,
"default_order_quantity": 6,
"volume_tiers": [
{
"start_quantity": 12,
"price": 21.99,
"step_increment": 1
}
]
}
],
"medias": [
{
"url": "https://cdn.example.com/cushion-red.jpg",
"type": "image",
"order": 1,
"is_default": true
}
],
"url_slug": "velvet-cushion-red-18",
"seo_info": {
"primary_title": "Velvet Cushion",
"title": "Velvet Cushion Red 18in | Auralane",
"description": "Soft velvet cushion cover with insert.",
"keywords": [
"cushion",
"velvet"
]
},
"channel_visibility": {
"website": "ShowForLoggedInUsersOnly"
},
"volume": {
"cbm": 0.02,
"cft": 0.7
}
}
]
}
'import requests
url = "https://api.wizcommerce.com/v1/products/bulk"
payload = { "data": [
{
"sku_id": "CUSH-RED-18",
"name": "Velvet Cushion Red 18in",
"id": "01f5d171-d3e3-4b2b-bd57-0727194b5bed",
"reference_id": "CUSH-RED-18",
"group_code": "CUSH-VELVET-18",
"keep_existing_group": False,
"is_primary": True,
"priority": 1,
"status": "active",
"brand": "Auralane",
"grouping_attributes": ["Color", "Size"],
"attributes": [
{
"id": "3f1c2b9e-7a1d-4c55-9a0e-2f8d6b1c4e21",
"name": "Color",
"value": "<unknown>"
}
],
"hinge_values": {},
"categories": ["Home Decor/Cushions"],
"collections": ["Winter 2026"],
"tags": ["velvet", "bestseller"],
"product_prices": [
{
"price": 24.99,
"price_list_id": "9c8b7a6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
"reference_id": "WHOLESALE",
"sale_price": 19.99,
"min_order_quantity": 1,
"step_increment": 1,
"max_order_quantity": 99999,
"default_order_quantity": 6,
"volume_tiers": [
{
"start_quantity": 12,
"price": 21.99,
"step_increment": 1
}
]
}
],
"medias": [
{
"url": "https://cdn.example.com/cushion-red.jpg",
"type": "image",
"order": 1,
"is_default": True
}
],
"url_slug": "velvet-cushion-red-18",
"seo_info": {
"primary_title": "Velvet Cushion",
"title": "Velvet Cushion Red 18in | Auralane",
"description": "Soft velvet cushion cover with insert.",
"keywords": ["cushion", "velvet"]
},
"channel_visibility": { "website": "ShowForLoggedInUsersOnly" },
"volume": {
"cbm": 0.02,
"cft": 0.7
}
}
] }
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
data: [
{
sku_id: 'CUSH-RED-18',
name: 'Velvet Cushion Red 18in',
id: '01f5d171-d3e3-4b2b-bd57-0727194b5bed',
reference_id: 'CUSH-RED-18',
group_code: 'CUSH-VELVET-18',
keep_existing_group: false,
is_primary: true,
priority: 1,
status: 'active',
brand: 'Auralane',
grouping_attributes: ['Color', 'Size'],
attributes: [
{id: '3f1c2b9e-7a1d-4c55-9a0e-2f8d6b1c4e21', name: 'Color', value: '<unknown>'}
],
hinge_values: {},
categories: ['Home Decor/Cushions'],
collections: ['Winter 2026'],
tags: ['velvet', 'bestseller'],
product_prices: [
{
price: 24.99,
price_list_id: '9c8b7a6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d',
reference_id: 'WHOLESALE',
sale_price: 19.99,
min_order_quantity: 1,
step_increment: 1,
max_order_quantity: 99999,
default_order_quantity: 6,
volume_tiers: [{start_quantity: 12, price: 21.99, step_increment: 1}]
}
],
medias: [
{
url: 'https://cdn.example.com/cushion-red.jpg',
type: 'image',
order: 1,
is_default: true
}
],
url_slug: 'velvet-cushion-red-18',
seo_info: {
primary_title: 'Velvet Cushion',
title: 'Velvet Cushion Red 18in | Auralane',
description: 'Soft velvet cushion cover with insert.',
keywords: ['cushion', 'velvet']
},
channel_visibility: {website: 'ShowForLoggedInUsersOnly'},
volume: {cbm: 0.02, cft: 0.7}
}
]
})
};
fetch('https://api.wizcommerce.com/v1/products/bulk', 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.wizcommerce.com/v1/products/bulk",
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([
'data' => [
[
'sku_id' => 'CUSH-RED-18',
'name' => 'Velvet Cushion Red 18in',
'id' => '01f5d171-d3e3-4b2b-bd57-0727194b5bed',
'reference_id' => 'CUSH-RED-18',
'group_code' => 'CUSH-VELVET-18',
'keep_existing_group' => false,
'is_primary' => true,
'priority' => 1,
'status' => 'active',
'brand' => 'Auralane',
'grouping_attributes' => [
'Color',
'Size'
],
'attributes' => [
[
'id' => '3f1c2b9e-7a1d-4c55-9a0e-2f8d6b1c4e21',
'name' => 'Color',
'value' => '<unknown>'
]
],
'hinge_values' => [
],
'categories' => [
'Home Decor/Cushions'
],
'collections' => [
'Winter 2026'
],
'tags' => [
'velvet',
'bestseller'
],
'product_prices' => [
[
'price' => 24.99,
'price_list_id' => '9c8b7a6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d',
'reference_id' => 'WHOLESALE',
'sale_price' => 19.99,
'min_order_quantity' => 1,
'step_increment' => 1,
'max_order_quantity' => 99999,
'default_order_quantity' => 6,
'volume_tiers' => [
[
'start_quantity' => 12,
'price' => 21.99,
'step_increment' => 1
]
]
]
],
'medias' => [
[
'url' => 'https://cdn.example.com/cushion-red.jpg',
'type' => 'image',
'order' => 1,
'is_default' => true
]
],
'url_slug' => 'velvet-cushion-red-18',
'seo_info' => [
'primary_title' => 'Velvet Cushion',
'title' => 'Velvet Cushion Red 18in | Auralane',
'description' => 'Soft velvet cushion cover with insert.',
'keywords' => [
'cushion',
'velvet'
]
],
'channel_visibility' => [
'website' => 'ShowForLoggedInUsersOnly'
],
'volume' => [
'cbm' => 0.02,
'cft' => 0.7
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <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://api.wizcommerce.com/v1/products/bulk"
payload := strings.NewReader("{\n \"data\": [\n {\n \"sku_id\": \"CUSH-RED-18\",\n \"name\": \"Velvet Cushion Red 18in\",\n \"id\": \"01f5d171-d3e3-4b2b-bd57-0727194b5bed\",\n \"reference_id\": \"CUSH-RED-18\",\n \"group_code\": \"CUSH-VELVET-18\",\n \"keep_existing_group\": false,\n \"is_primary\": true,\n \"priority\": 1,\n \"status\": \"active\",\n \"brand\": \"Auralane\",\n \"grouping_attributes\": [\n \"Color\",\n \"Size\"\n ],\n \"attributes\": [\n {\n \"id\": \"3f1c2b9e-7a1d-4c55-9a0e-2f8d6b1c4e21\",\n \"name\": \"Color\",\n \"value\": \"<unknown>\"\n }\n ],\n \"hinge_values\": {},\n \"categories\": [\n \"Home Decor/Cushions\"\n ],\n \"collections\": [\n \"Winter 2026\"\n ],\n \"tags\": [\n \"velvet\",\n \"bestseller\"\n ],\n \"product_prices\": [\n {\n \"price\": 24.99,\n \"price_list_id\": \"9c8b7a6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d\",\n \"reference_id\": \"WHOLESALE\",\n \"sale_price\": 19.99,\n \"min_order_quantity\": 1,\n \"step_increment\": 1,\n \"max_order_quantity\": 99999,\n \"default_order_quantity\": 6,\n \"volume_tiers\": [\n {\n \"start_quantity\": 12,\n \"price\": 21.99,\n \"step_increment\": 1\n }\n ]\n }\n ],\n \"medias\": [\n {\n \"url\": \"https://cdn.example.com/cushion-red.jpg\",\n \"type\": \"image\",\n \"order\": 1,\n \"is_default\": true\n }\n ],\n \"url_slug\": \"velvet-cushion-red-18\",\n \"seo_info\": {\n \"primary_title\": \"Velvet Cushion\",\n \"title\": \"Velvet Cushion Red 18in | Auralane\",\n \"description\": \"Soft velvet cushion cover with insert.\",\n \"keywords\": [\n \"cushion\",\n \"velvet\"\n ]\n },\n \"channel_visibility\": {\n \"website\": \"ShowForLoggedInUsersOnly\"\n },\n \"volume\": {\n \"cbm\": 0.02,\n \"cft\": 0.7\n }\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<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://api.wizcommerce.com/v1/products/bulk")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"data\": [\n {\n \"sku_id\": \"CUSH-RED-18\",\n \"name\": \"Velvet Cushion Red 18in\",\n \"id\": \"01f5d171-d3e3-4b2b-bd57-0727194b5bed\",\n \"reference_id\": \"CUSH-RED-18\",\n \"group_code\": \"CUSH-VELVET-18\",\n \"keep_existing_group\": false,\n \"is_primary\": true,\n \"priority\": 1,\n \"status\": \"active\",\n \"brand\": \"Auralane\",\n \"grouping_attributes\": [\n \"Color\",\n \"Size\"\n ],\n \"attributes\": [\n {\n \"id\": \"3f1c2b9e-7a1d-4c55-9a0e-2f8d6b1c4e21\",\n \"name\": \"Color\",\n \"value\": \"<unknown>\"\n }\n ],\n \"hinge_values\": {},\n \"categories\": [\n \"Home Decor/Cushions\"\n ],\n \"collections\": [\n \"Winter 2026\"\n ],\n \"tags\": [\n \"velvet\",\n \"bestseller\"\n ],\n \"product_prices\": [\n {\n \"price\": 24.99,\n \"price_list_id\": \"9c8b7a6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d\",\n \"reference_id\": \"WHOLESALE\",\n \"sale_price\": 19.99,\n \"min_order_quantity\": 1,\n \"step_increment\": 1,\n \"max_order_quantity\": 99999,\n \"default_order_quantity\": 6,\n \"volume_tiers\": [\n {\n \"start_quantity\": 12,\n \"price\": 21.99,\n \"step_increment\": 1\n }\n ]\n }\n ],\n \"medias\": [\n {\n \"url\": \"https://cdn.example.com/cushion-red.jpg\",\n \"type\": \"image\",\n \"order\": 1,\n \"is_default\": true\n }\n ],\n \"url_slug\": \"velvet-cushion-red-18\",\n \"seo_info\": {\n \"primary_title\": \"Velvet Cushion\",\n \"title\": \"Velvet Cushion Red 18in | Auralane\",\n \"description\": \"Soft velvet cushion cover with insert.\",\n \"keywords\": [\n \"cushion\",\n \"velvet\"\n ]\n },\n \"channel_visibility\": {\n \"website\": \"ShowForLoggedInUsersOnly\"\n },\n \"volume\": {\n \"cbm\": 0.02,\n \"cft\": 0.7\n }\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.wizcommerce.com/v1/products/bulk")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"data\": [\n {\n \"sku_id\": \"CUSH-RED-18\",\n \"name\": \"Velvet Cushion Red 18in\",\n \"id\": \"01f5d171-d3e3-4b2b-bd57-0727194b5bed\",\n \"reference_id\": \"CUSH-RED-18\",\n \"group_code\": \"CUSH-VELVET-18\",\n \"keep_existing_group\": false,\n \"is_primary\": true,\n \"priority\": 1,\n \"status\": \"active\",\n \"brand\": \"Auralane\",\n \"grouping_attributes\": [\n \"Color\",\n \"Size\"\n ],\n \"attributes\": [\n {\n \"id\": \"3f1c2b9e-7a1d-4c55-9a0e-2f8d6b1c4e21\",\n \"name\": \"Color\",\n \"value\": \"<unknown>\"\n }\n ],\n \"hinge_values\": {},\n \"categories\": [\n \"Home Decor/Cushions\"\n ],\n \"collections\": [\n \"Winter 2026\"\n ],\n \"tags\": [\n \"velvet\",\n \"bestseller\"\n ],\n \"product_prices\": [\n {\n \"price\": 24.99,\n \"price_list_id\": \"9c8b7a6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d\",\n \"reference_id\": \"WHOLESALE\",\n \"sale_price\": 19.99,\n \"min_order_quantity\": 1,\n \"step_increment\": 1,\n \"max_order_quantity\": 99999,\n \"default_order_quantity\": 6,\n \"volume_tiers\": [\n {\n \"start_quantity\": 12,\n \"price\": 21.99,\n \"step_increment\": 1\n }\n ]\n }\n ],\n \"medias\": [\n {\n \"url\": \"https://cdn.example.com/cushion-red.jpg\",\n \"type\": \"image\",\n \"order\": 1,\n \"is_default\": true\n }\n ],\n \"url_slug\": \"velvet-cushion-red-18\",\n \"seo_info\": {\n \"primary_title\": \"Velvet Cushion\",\n \"title\": \"Velvet Cushion Red 18in | Auralane\",\n \"description\": \"Soft velvet cushion cover with insert.\",\n \"keywords\": [\n \"cushion\",\n \"velvet\"\n ]\n },\n \"channel_visibility\": {\n \"website\": \"ShowForLoggedInUsersOnly\"\n },\n \"volume\": {\n \"cbm\": 0.02,\n \"cft\": 0.7\n }\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": [
{
"index": 0,
"status": "success",
"id": "01f5d171-d3e3-4b2b-bd57-0727194b5bed",
"parent_id": "8e7d6c5b-4a39-4b2c-a1d0-f9e8d7c6b5a4",
"reference_id": "CUSH-RED-18",
"sku_id": "CUSH-RED-18",
"group_code": "CUSH-VELVET-18",
"action": "create",
"indexed": true,
"error": {
"code": "NOT_FOUND",
"message": "Category 'Bedding/Cushions' not found"
},
"mapping_errors": {}
}
],
"meta": {
"total": 2,
"success": 2,
"failed": 0
}
}{
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"reason": "<string>"
}
]
}{
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"reason": "<string>"
}
]
}{
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"reason": "<string>"
}
]
}{
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"reason": "<string>"
}
]
}{
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"reason": "<string>"
}
]
}{
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"reason": "<string>"
}
]
}{
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"reason": "<string>"
}
]
}{
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"reason": "<string>"
}
]
}Authorizations
API Key for authentication
Body
application/json
1-100 items; body must not exceed 10 MiB
1-100 variants. reference_id and id must be unique within the batch. Body must not exceed 10 MiB.
Required array length:
1 - 100 elementsShow child attributes
Show child attributes
Was this page helpful?