# 1. Catalog (Simple) Sync

Catalog Sync — After onboarding, bulk creation‑only import of simple (non‑variant) products.
Asynchronous, batched; track via requestId/batchId, final summary via webhook.

Stock/Warehouse rules (per product):

Single stock level only: use stock or warehouses, not both.
Warehouse count = 0: only stock is allowed.
Warehouse count = 1:
- stock → translated to single warehouse allocation
- warehouses → allowed
Warehouse count > 1:
- stock → distributed to all warehouses
- warehouses → applies only to specified clientIds
Warehouse items require valid clientId and stock.

Overview

HMACASYNC

At a glance

Runs asynchronously (batched).
Bulk import in batches.
Contains variant items detail.
Warehouse support.
Track via requestId / batchId.

Auth: HMAC Partner
Method: POST

# Path

https://partners-api.tocobagus.net/api/v1 /partner/stores/catalog/sync

# Request

Query parameters: None.

# Required Headers

Header	Example	Description
`x-signature`	bdbb8833fe43671e058b56dace75763a78a2edf8de7365afb6f534d750056e80	HMAC signature of the request, computed with the partner secret and `x-timestamp` (auth integrity).
`x-partner-client-id`	2025112012475048491498	Partner identifier issued by Omni; used to locate the partner secret.
`x-store-client-id`	638765489981529612855	Target store identifier under the partner account.
`x-store-token`	stkn__6AbJF05mjvxh7sh	Store access token for store-level authorization.
`x-timestamp`	1758100350458	UNIX epoch timestamp used when computing `x-signature` (replay protection).

# Request Payload

Content-Type: application/json

# Example Body Payload

{
  "products": [
    {
      "externalId": "c07fb1a2-8e5b-48c5-aba0-60a3aa60de9c",
      "name": "Cars Tshir - Berskha ",
      "description": "Comfortable cotton t-shirt, available in multiple colors.",
      "sku": "TSHIRT001",
      "price": 100000,
      "specialPrice": 95000,
      "stock": 50,
      "weight": 250,
      "dimensions": {
        "length": 12,
        "width": 12,
        "height": 10
      },
      "minOrder": 1,
      "subCategoryId": "0e882586-c506-4792-a831-02767a68dae2",
      "categoryId": "2fde2994-28a8-4d09-a128-6d744b9e1323",
      "typeId": "d86db295-41c3-423d-a2c2-a59724f38316",
      "hashtags": [
        "tshirt",
        "cotton",
        "basic",
        "unisex"
      ],
      "condition": "NEW",
      "photos": [
        "https://static.bershka.net/assets/public/c098/cf02/43994a8b85c2/ab5f1d198b45/02435167600-a2d/02435167600-a2d.jpg?ts=1743675222962&w=800",
        "https://static.bershka.net/assets/public/1583/fb4b/acc54f0c9852/8b3e59357b70/02435167600-a3o/02435167600-a3o.jpg?ts=1743675223481&w=800",
        "https://static.bershka.net/assets/public/9f25/5445/521b435cbbf3/a742381edcb6/02435167600-a4o/02435167600-a4o.jpg?ts=1743587709510&w=800",
        "https://static.bershka.net/assets/public/9dcd/fbe0/f9e940898623/9f81b51db96d/02435167600-p/02435167600-p.jpg?ts=1743675211854&w=800",
        "https://static.bershka.net/assets/public/4675/d9f6/0ac64372b6d7/3df6aa8db2ae/02435167600-b/02435167600-b.jpg?ts=1743587709886&w=800"
      ],
      "isPreorder": false,
      "preorderPeriod": 0,
      "isArchived": false,
      "insuranceRequired": true,
      "codEnabled": false
    },
    {
      "externalId": "a7114011-963b-48c5-96c8-50f3b8661494",
      "name": "Laptop Backpack",
      "description": "Water-resistant backpack with laptop compartment.",
      "sku": "BAG002",
      "price": 300000,
      "specialPrice": 270000,
      "stock": 20,
      "weight": 800,
      "dimensions": {
        "length": 12,
        "width": 12,
        "height": 10
      },
      "minOrder": 1,
      "subCategoryId": "0e882586-c506-4792-a831-02767a68dae2",
      "categoryId": "2fde2994-28a8-4d09-a128-6d744b9e1323",
      "typeId": "d86db295-41c3-423d-a2c2-a59724f38316",
      "hashtags": [
        "backpack",
        "laptop",
        "bag"
      ],
      "condition": "NEW",
      "photos": [
        "https://media.startech.com/cms/products/main/ntbkbag156.main.jpg",
        "https://media.startech.com/cms/products/main/ntbkbag156.m.jpg",
        "https://media.startech.com/cms/products/main/ntbkbag156.o.jpg"
      ],
      "isPreorder": false,
      "preorderPeriod": 0,
      "isArchived": false,
      "insuranceRequired": true,
      "codEnabled": false
    },
    {
      "externalId": "a0923ad1-eab6-49cb-8af1-cbcb041c7092",
      "name": "Ceramic Mug",
      "description": "Minimalist ceramic mug, perfect for coffee or tea.",
      "sku": "MUG003",
      "price": 45000,
      "specialPrice": 40000,
      "stock": 100,
      "weight": 400,
      "dimensions": {
        "length": 12,
        "width": 12,
        "height": 10
      },
      "minOrder": 2,
      "subCategoryId": "0e882586-c506-4792-a831-02767a68dae2",
      "categoryId": "2fde2994-28a8-4d09-a128-6d744b9e1323",
      "typeId": "d86db295-41c3-423d-a2c2-a59724f38316",
      "hashtags": [
        "mug",
        "ceramic",
        "kitchen"
      ],
      "condition": "NEW",
      "photos": [
        "https://stickyearthceramics.sg/cdn/shop/products/green_mug_1_2048pxCOMPRESSED_600x.jpg?v=1728260970",
        "https://stickyearthceramics.sg/cdn/shop/products/white_mug_1_2048px_600x.jpg?v=1728232386",
        "https://stickyearthceramics.sg/cdn/shop/products/henge_carved_mug_1_2048px_compressed_600x.jpg?v=1728232369"
      ],
      "isPreorder": false,
      "preorderPeriod": 0,
      "isArchived": false,
      "insuranceRequired": true,
      "codEnabled": false
    }
  ]
}

# Example Request

Curl Node.js Go Java

curl -X POST "http:///partner/stores/catalog/sync" \
  -H "Content-Type: application/json" \
  -H "x-signature: bdbb8833fe43671e058b56dace75763a78a2edf8de7365afb6f534d750056e80" \
  -H "x-partner-client-id: 2025112012475048491498" \
  -H "x-store-client-id: 638765489981529612855" \
  -H "x-store-token: stkn__6AbJF05mjvxh7sh" \
  -H "x-timestamp: 1758100350458" \
  --data '{"products":[{"externalId":"c07fb1a2-8e5b-48c5-aba0-60a3aa60de9c","name":"Cars Tshir - Berskha ","description":"Comfortable cotton t-shirt, available in multiple colors.","sku":"TSHIRT001","price":100000,"specialPrice":95000,"stock":50,"weight":250,"dimensions":{"length":12,"width":12,"height":10},"minOrder":1,"subCategoryId":"0e882586-c506-4792-a831-02767a68dae2","categoryId":"2fde2994-28a8-4d09-a128-6d744b9e1323","typeId":"d86db295-41c3-423d-a2c2-a59724f38316","hashtags":["tshirt","cotton","basic","unisex"],"condition":"NEW","photos":["https://static.bershka.net/assets/public/c098/cf02/43994a8b85c2/ab5f1d198b45/02435167600-a2d/02435167600-a2d.jpg?ts=1743675222962&w=800","https://static.bershka.net/assets/public/1583/fb4b/acc54f0c9852/8b3e59357b70/02435167600-a3o/02435167600-a3o.jpg?ts=1743675223481&w=800","https://static.bershka.net/assets/public/9f25/5445/521b435cbbf3/a742381edcb6/02435167600-a4o/02435167600-a4o.jpg?ts=1743587709510&w=800","https://static.bershka.net/assets/public/9dcd/fbe0/f9e940898623/9f81b51db96d/02435167600-p/02435167600-p.jpg?ts=1743675211854&w=800","https://static.bershka.net/assets/public/4675/d9f6/0ac64372b6d7/3df6aa8db2ae/02435167600-b/02435167600-b.jpg?ts=1743587709886&w=800"],"isPreorder":false,"preorderPeriod":0,"isArchived":false,"insuranceRequired":true,"codEnabled":false},{"externalId":"a7114011-963b-48c5-96c8-50f3b8661494","name":"Laptop Backpack","description":"Water-resistant backpack with laptop compartment.","sku":"BAG002","price":300000,"specialPrice":270000,"stock":20,"weight":800,"dimensions":{"length":12,"width":12,"height":10},"minOrder":1,"subCategoryId":"0e882586-c506-4792-a831-02767a68dae2","categoryId":"2fde2994-28a8-4d09-a128-6d744b9e1323","typeId":"d86db295-41c3-423d-a2c2-a59724f38316","hashtags":["backpack","laptop","bag"],"condition":"NEW","photos":["https://media.startech.com/cms/products/main/ntbkbag156.main.jpg","https://media.startech.com/cms/products/main/ntbkbag156.m.jpg","https://media.startech.com/cms/products/main/ntbkbag156.o.jpg"],"isPreorder":false,"preorderPeriod":0,"isArchived":false,"insuranceRequired":true,"codEnabled":false},{"externalId":"a0923ad1-eab6-49cb-8af1-cbcb041c7092","name":"Ceramic Mug","description":"Minimalist ceramic mug, perfect for coffee or tea.","sku":"MUG003","price":45000,"specialPrice":40000,"stock":100,"weight":400,"dimensions":{"length":12,"width":12,"height":10},"minOrder":2,"subCategoryId":"0e882586-c506-4792-a831-02767a68dae2","categoryId":"2fde2994-28a8-4d09-a128-6d744b9e1323","typeId":"d86db295-41c3-423d-a2c2-a59724f38316","hashtags":["mug","ceramic","kitchen"],"condition":"NEW","photos":["https://stickyearthceramics.sg/cdn/shop/products/green_mug_1_2048pxCOMPRESSED_600x.jpg?v=1728260970","https://stickyearthceramics.sg/cdn/shop/products/white_mug_1_2048px_600x.jpg?v=1728232386","https://stickyearthceramics.sg/cdn/shop/products/henge_carved_mug_1_2048px_compressed_600x.jpg?v=1728232369"],"isPreorder":false,"preorderPeriod":0,"isArchived":false,"insuranceRequired":true,"codEnabled":false}]}'

const qs = new URLSearchParams({});
const url = "http:///partner/stores/catalog/sync" + (qs.toString() ? "?" + qs.toString() : "");
const res = await fetch(url, {
  method: "POST",
  headers: {
  "x-signature": "bdbb8833fe43671e058b56dace75763a78a2edf8de7365afb6f534d750056e80",
  "x-partner-client-id": "2025112012475048491498",
  "x-store-client-id": "638765489981529612855",
  "x-store-token": "stkn__6AbJF05mjvxh7sh",
  "x-timestamp": "1758100350458"
},
  body: JSON.stringify({"products":[{"externalId":"c07fb1a2-8e5b-48c5-aba0-60a3aa60de9c","name":"Cars Tshir - Berskha ","description":"Comfortable cotton t-shirt, available in multiple colors.","sku":"TSHIRT001","price":100000,"specialPrice":95000,"stock":50,"weight":250,"dimensions":{"length":12,"width":12,"height":10},"minOrder":1,"subCategoryId":"0e882586-c506-4792-a831-02767a68dae2","categoryId":"2fde2994-28a8-4d09-a128-6d744b9e1323","typeId":"d86db295-41c3-423d-a2c2-a59724f38316","hashtags":["tshirt","cotton","basic","unisex"],"condition":"NEW","photos":["https://static.bershka.net/assets/public/c098/cf02/43994a8b85c2/ab5f1d198b45/02435167600-a2d/02435167600-a2d.jpg?ts=1743675222962&w=800","https://static.bershka.net/assets/public/1583/fb4b/acc54f0c9852/8b3e59357b70/02435167600-a3o/02435167600-a3o.jpg?ts=1743675223481&w=800","https://static.bershka.net/assets/public/9f25/5445/521b435cbbf3/a742381edcb6/02435167600-a4o/02435167600-a4o.jpg?ts=1743587709510&w=800","https://static.bershka.net/assets/public/9dcd/fbe0/f9e940898623/9f81b51db96d/02435167600-p/02435167600-p.jpg?ts=1743675211854&w=800","https://static.bershka.net/assets/public/4675/d9f6/0ac64372b6d7/3df6aa8db2ae/02435167600-b/02435167600-b.jpg?ts=1743587709886&w=800"],"isPreorder":false,"preorderPeriod":0,"isArchived":false,"insuranceRequired":true,"codEnabled":false},{"externalId":"a7114011-963b-48c5-96c8-50f3b8661494","name":"Laptop Backpack","description":"Water-resistant backpack with laptop compartment.","sku":"BAG002","price":300000,"specialPrice":270000,"stock":20,"weight":800,"dimensions":{"length":12,"width":12,"height":10},"minOrder":1,"subCategoryId":"0e882586-c506-4792-a831-02767a68dae2","categoryId":"2fde2994-28a8-4d09-a128-6d744b9e1323","typeId":"d86db295-41c3-423d-a2c2-a59724f38316","hashtags":["backpack","laptop","bag"],"condition":"NEW","photos":["https://media.startech.com/cms/products/main/ntbkbag156.main.jpg","https://media.startech.com/cms/products/main/ntbkbag156.m.jpg","https://media.startech.com/cms/products/main/ntbkbag156.o.jpg"],"isPreorder":false,"preorderPeriod":0,"isArchived":false,"insuranceRequired":true,"codEnabled":false},{"externalId":"a0923ad1-eab6-49cb-8af1-cbcb041c7092","name":"Ceramic Mug","description":"Minimalist ceramic mug, perfect for coffee or tea.","sku":"MUG003","price":45000,"specialPrice":40000,"stock":100,"weight":400,"dimensions":{"length":12,"width":12,"height":10},"minOrder":2,"subCategoryId":"0e882586-c506-4792-a831-02767a68dae2","categoryId":"2fde2994-28a8-4d09-a128-6d744b9e1323","typeId":"d86db295-41c3-423d-a2c2-a59724f38316","hashtags":["mug","ceramic","kitchen"],"condition":"NEW","photos":["https://stickyearthceramics.sg/cdn/shop/products/green_mug_1_2048pxCOMPRESSED_600x.jpg?v=1728260970","https://stickyearthceramics.sg/cdn/shop/products/white_mug_1_2048px_600x.jpg?v=1728232386","https://stickyearthceramics.sg/cdn/shop/products/henge_carved_mug_1_2048px_compressed_600x.jpg?v=1728232369"],"isPreorder":false,"preorderPeriod":0,"isArchived":false,"insuranceRequired":true,"codEnabled":false}]})
});
const json = await res.json();
console.log(json);

qs := url.Values{}

u := "http:///partner/stores/catalog/sync"
if q := qs.Encode(); q != "" { u = u + "?" + q }
req, _ := http.NewRequest("POST", u, bytes.NewBufferString("{\"products\":[{\"externalId\":\"c07fb1a2-8e5b-48c5-aba0-60a3aa60de9c\",\"name\":\"Cars Tshir - Berskha \",\"description\":\"Comfortable cotton t-shirt, available in multiple colors.\",\"sku\":\"TSHIRT001\",\"price\":100000,\"specialPrice\":95000,\"stock\":50,\"weight\":250,\"dimensions\":{\"length\":12,\"width\":12,\"height\":10},\"minOrder\":1,\"subCategoryId\":\"0e882586-c506-4792-a831-02767a68dae2\",\"categoryId\":\"2fde2994-28a8-4d09-a128-6d744b9e1323\",\"typeId\":\"d86db295-41c3-423d-a2c2-a59724f38316\",\"hashtags\":[\"tshirt\",\"cotton\",\"basic\",\"unisex\"],\"condition\":\"NEW\",\"photos\":[\"https://static.bershka.net/assets/public/c098/cf02/43994a8b85c2/ab5f1d198b45/02435167600-a2d/02435167600-a2d.jpg?ts=1743675222962&w=800\",\"https://static.bershka.net/assets/public/1583/fb4b/acc54f0c9852/8b3e59357b70/02435167600-a3o/02435167600-a3o.jpg?ts=1743675223481&w=800\",\"https://static.bershka.net/assets/public/9f25/5445/521b435cbbf3/a742381edcb6/02435167600-a4o/02435167600-a4o.jpg?ts=1743587709510&w=800\",\"https://static.bershka.net/assets/public/9dcd/fbe0/f9e940898623/9f81b51db96d/02435167600-p/02435167600-p.jpg?ts=1743675211854&w=800\",\"https://static.bershka.net/assets/public/4675/d9f6/0ac64372b6d7/3df6aa8db2ae/02435167600-b/02435167600-b.jpg?ts=1743587709886&w=800\"],\"isPreorder\":false,\"preorderPeriod\":0,\"isArchived\":false,\"insuranceRequired\":true,\"codEnabled\":false},{\"externalId\":\"a7114011-963b-48c5-96c8-50f3b8661494\",\"name\":\"Laptop Backpack\",\"description\":\"Water-resistant backpack with laptop compartment.\",\"sku\":\"BAG002\",\"price\":300000,\"specialPrice\":270000,\"stock\":20,\"weight\":800,\"dimensions\":{\"length\":12,\"width\":12,\"height\":10},\"minOrder\":1,\"subCategoryId\":\"0e882586-c506-4792-a831-02767a68dae2\",\"categoryId\":\"2fde2994-28a8-4d09-a128-6d744b9e1323\",\"typeId\":\"d86db295-41c3-423d-a2c2-a59724f38316\",\"hashtags\":[\"backpack\",\"laptop\",\"bag\"],\"condition\":\"NEW\",\"photos\":[\"https://media.startech.com/cms/products/main/ntbkbag156.main.jpg\",\"https://media.startech.com/cms/products/main/ntbkbag156.m.jpg\",\"https://media.startech.com/cms/products/main/ntbkbag156.o.jpg\"],\"isPreorder\":false,\"preorderPeriod\":0,\"isArchived\":false,\"insuranceRequired\":true,\"codEnabled\":false},{\"externalId\":\"a0923ad1-eab6-49cb-8af1-cbcb041c7092\",\"name\":\"Ceramic Mug\",\"description\":\"Minimalist ceramic mug, perfect for coffee or tea.\",\"sku\":\"MUG003\",\"price\":45000,\"specialPrice\":40000,\"stock\":100,\"weight\":400,\"dimensions\":{\"length\":12,\"width\":12,\"height\":10},\"minOrder\":2,\"subCategoryId\":\"0e882586-c506-4792-a831-02767a68dae2\",\"categoryId\":\"2fde2994-28a8-4d09-a128-6d744b9e1323\",\"typeId\":\"d86db295-41c3-423d-a2c2-a59724f38316\",\"hashtags\":[\"mug\",\"ceramic\",\"kitchen\"],\"condition\":\"NEW\",\"photos\":[\"https://stickyearthceramics.sg/cdn/shop/products/green_mug_1_2048pxCOMPRESSED_600x.jpg?v=1728260970\",\"https://stickyearthceramics.sg/cdn/shop/products/white_mug_1_2048px_600x.jpg?v=1728232386\",\"https://stickyearthceramics.sg/cdn/shop/products/henge_carved_mug_1_2048px_compressed_600x.jpg?v=1728232369\"],\"isPreorder\":false,\"preorderPeriod\":0,\"isArchived\":false,\"insuranceRequired\":true,\"codEnabled\":false}]}"))
req.Header.Set("x-signature", "bdbb8833fe43671e058b56dace75763a78a2edf8de7365afb6f534d750056e80")
req.Header.Set("x-partner-client-id", "2025112012475048491498")
req.Header.Set("x-store-client-id", "638765489981529612855")
req.Header.Set("x-store-token", "stkn__6AbJF05mjvxh7sh")
req.Header.Set("x-timestamp", "1758100350458")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
b, _ := io.ReadAll(resp.Body)
fmt.Println(string(b))

var client = java.net.http.HttpClient.newHttpClient();
var req = java.net.http.HttpRequest.newBuilder()
    .uri(java.net.URI.create("http:///partner/stores/catalog/sync"))
    .header("Content-Type","application/json")
    .header("x-signature", "bdbb8833fe43671e058b56dace75763a78a2edf8de7365afb6f534d750056e80")
    .header("x-partner-client-id", "2025112012475048491498")
    .header("x-store-client-id", "638765489981529612855")
    .header("x-store-token", "stkn__6AbJF05mjvxh7sh")
    .header("x-timestamp", "1758100350458")
    .method("POST", java.net.http.HttpRequest.BodyPublishers.ofString("{\"products\":[{\"externalId\":\"c07fb1a2-8e5b-48c5-aba0-60a3aa60de9c\",\"name\":\"Cars Tshir - Berskha \",\"description\":\"Comfortable cotton t-shirt, available in multiple colors.\",\"sku\":\"TSHIRT001\",\"price\":100000,\"specialPrice\":95000,\"stock\":50,\"weight\":250,\"dimensions\":{\"length\":12,\"width\":12,\"height\":10},\"minOrder\":1,\"subCategoryId\":\"0e882586-c506-4792-a831-02767a68dae2\",\"categoryId\":\"2fde2994-28a8-4d09-a128-6d744b9e1323\",\"typeId\":\"d86db295-41c3-423d-a2c2-a59724f38316\",\"hashtags\":[\"tshirt\",\"cotton\",\"basic\",\"unisex\"],\"condition\":\"NEW\",\"photos\":[\"https://static.bershka.net/assets/public/c098/cf02/43994a8b85c2/ab5f1d198b45/02435167600-a2d/02435167600-a2d.jpg?ts=1743675222962&w=800\",\"https://static.bershka.net/assets/public/1583/fb4b/acc54f0c9852/8b3e59357b70/02435167600-a3o/02435167600-a3o.jpg?ts=1743675223481&w=800\",\"https://static.bershka.net/assets/public/9f25/5445/521b435cbbf3/a742381edcb6/02435167600-a4o/02435167600-a4o.jpg?ts=1743587709510&w=800\",\"https://static.bershka.net/assets/public/9dcd/fbe0/f9e940898623/9f81b51db96d/02435167600-p/02435167600-p.jpg?ts=1743675211854&w=800\",\"https://static.bershka.net/assets/public/4675/d9f6/0ac64372b6d7/3df6aa8db2ae/02435167600-b/02435167600-b.jpg?ts=1743587709886&w=800\"],\"isPreorder\":false,\"preorderPeriod\":0,\"isArchived\":false,\"insuranceRequired\":true,\"codEnabled\":false},{\"externalId\":\"a7114011-963b-48c5-96c8-50f3b8661494\",\"name\":\"Laptop Backpack\",\"description\":\"Water-resistant backpack with laptop compartment.\",\"sku\":\"BAG002\",\"price\":300000,\"specialPrice\":270000,\"stock\":20,\"weight\":800,\"dimensions\":{\"length\":12,\"width\":12,\"height\":10},\"minOrder\":1,\"subCategoryId\":\"0e882586-c506-4792-a831-02767a68dae2\",\"categoryId\":\"2fde2994-28a8-4d09-a128-6d744b9e1323\",\"typeId\":\"d86db295-41c3-423d-a2c2-a59724f38316\",\"hashtags\":[\"backpack\",\"laptop\",\"bag\"],\"condition\":\"NEW\",\"photos\":[\"https://media.startech.com/cms/products/main/ntbkbag156.main.jpg\",\"https://media.startech.com/cms/products/main/ntbkbag156.m.jpg\",\"https://media.startech.com/cms/products/main/ntbkbag156.o.jpg\"],\"isPreorder\":false,\"preorderPeriod\":0,\"isArchived\":false,\"insuranceRequired\":true,\"codEnabled\":false},{\"externalId\":\"a0923ad1-eab6-49cb-8af1-cbcb041c7092\",\"name\":\"Ceramic Mug\",\"description\":\"Minimalist ceramic mug, perfect for coffee or tea.\",\"sku\":\"MUG003\",\"price\":45000,\"specialPrice\":40000,\"stock\":100,\"weight\":400,\"dimensions\":{\"length\":12,\"width\":12,\"height\":10},\"minOrder\":2,\"subCategoryId\":\"0e882586-c506-4792-a831-02767a68dae2\",\"categoryId\":\"2fde2994-28a8-4d09-a128-6d744b9e1323\",\"typeId\":\"d86db295-41c3-423d-a2c2-a59724f38316\",\"hashtags\":[\"mug\",\"ceramic\",\"kitchen\"],\"condition\":\"NEW\",\"photos\":[\"https://stickyearthceramics.sg/cdn/shop/products/green_mug_1_2048pxCOMPRESSED_600x.jpg?v=1728260970\",\"https://stickyearthceramics.sg/cdn/shop/products/white_mug_1_2048px_600x.jpg?v=1728232386\",\"https://stickyearthceramics.sg/cdn/shop/products/henge_carved_mug_1_2048px_compressed_600x.jpg?v=1728232369\"],\"isPreorder\":false,\"preorderPeriod\":0,\"isArchived\":false,\"insuranceRequired\":true,\"codEnabled\":false}]}"))
    .build();
var res = client.send(req, java.net.http.HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

# Responses

# Example Responses

202 Accepted

{
  "success": true,
  "message": "Catalog sync request accepted",
  "requestId": "ba12db1c-5f29-4791-ba01-b049326b97d9",
  "meta": {
    "timestamp": "2026-02-05T00:14:43.731Z",
    "durationMs": 5,
    "dispatch": true
  },
  "data": {
    "summary": {
      "total": 3,
      "failed": 0,
      "pending": 3
    },
    "acceptedRows": [
      {
        "rowIndex": 0,
        "externalId": "c07fb1a2-8e5b-48c5-aba0-60a3aa60de9c",
        "sku": "TSHIRT001"
      },
      {
        "rowIndex": 1,
        "externalId": "a7114011-963b-48c5-96c8-50f3b8661494",
        "sku": "BAG002"
      },
      {
        "rowIndex": 2,
        "externalId": "a0923ad1-eab6-49cb-8af1-cbcb041c7092",
        "sku": "MUG003"
      }
    ],
    "errors": []
  }
}

401 Unauthorized

{
  "success": false,
  "error": {
    "code": "AUTH_010",
    "message": "Invalid signature",
    "details": {
      "timestamp": "2026-02-05T00:09:03.451Z",
      "hint": "Invalid HMAC signature",
      "context": {
        "partnerClientId": "2025112512510620439726"
      }
    }
  },
  "requestId": "4aa3fd35-26b3-4648-aa0c-a3f107aaf4bd"
}

422 Unprocessable Entity

{
  "success": false,
  "error": {
    "code": "VAL_001",
    "message": "Validation failed",
    "details": {
      "timestamp": "2026-02-05T00:03:01.162Z",
      "hint": "Please check your request data and try again",
      "context": {
        "validationErrors": {
          "products": {
            "0": {
              "weight": "property weight should not exist",
              "externalId": "externalId must be shorter than or equal to 255 characters, externalId must be a string"
            },
            "1": {
              "weight": "property weight should not exist",
              "externalId": "externalId must be shorter than or equal to 255 characters, externalId must be a string"
            },
            "2": {
              "weight": "property weight should not exist",
              "externalId": "externalId must be shorter than or equal to 255 characters, externalId must be a string"
            }
          }
        }
      }
    }
  },
  "requestId": "41561531-5af3-47df-ba8b-2d3b2240a968"
}

# Dictionary

None for this endpoint.

# Notes

Does not support variants — use API Catalog With Variants Sync for product with variants,
POST-ONBOARDING ONLY: For routine product creation, use the Product module APIs.