# 1. Create Products (Simple)

Bulk Product Upload — Bulk create/update products (warehouse-aware) for routine sync. Runs as an asynchronous, batched job; track via requestId/batchId. Returns per-item outcomes and a processing summary in the standard response envelope.

Overview

HMACASYNC

At a glance

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

Auth: HMAC Partner
Method: POST

# Path

https://partners-api.tocobagus.net/api/v1 /partner/stores/products/bulk

# 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": "bace66be-47c4-4f72-868c-ad792da8b210",
      "name": "Ai Yazawa Short Sleeve UTX",
      "description": "Comfortable cotton t-shirt, available in multiple colors.",
      "sku": "480166",
      "price": 200000,
      "specialPrice": null,
      "stock": 900,
      "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",
      "brandId": "addcaa1b-8cdb-4c9a-9e5d-8b0fbbacfaea",
      "hashtags": [
        "uniqlo",
        "tshirt",
        "Yazawa",
        "japan",
        "Unisex"
      ],
      "condition": "NEW",
      "photos": [
        "https://image.uniqlo.com/UQ/ST3/id/imagesgoods/480166/item/idgoods_00_480166_3x4.jpg?width=369",
        "https://image.uniqlo.com/UQ/ST3/AsianCommon/imagesgoods/480166/sub/goods_480166_sub14_3x4.jpg?width=369"
      ],
      "officialBanners": [
        "https://image.uniqlo.com/UQ/ST3/id/imagesgoods/480166/item/idgoods_00_480166_3x4.jpg?width=369"
      ],
      "isPreorder": false,
      "preorderPeriod": 0,
      "isArchived": false,
      "insuranceRequired": true,
      "codEnabled": false
    },
    {
      "externalId": "52a3bcfb-62ea-4711-a4c1-b6847a981256",
      "name": "Ai Yazawa Short Sleeve UTX",
      "description": "Water-resistant backpack with laptop compartment.",
      "sku": "480167",
      "price": 190000,
      "specialPrice": 150000,
      "weight": 800,
      "minOrder": 1,
      "subCategoryId": "0e882586-c506-4792-a831-02767a6844e2",
      "categoryId": "2fde2994-28a8-4d09-a128-6d744b9e1323",
      "typeId": "d86db295-41c3-423d-a2c2-a59724f38316",
      "hashtags": [
        "tshirt",
        "Yazawa",
        "Japan"
      ],
      "condition": "NEW",
      "photos": [
        "https://image.uniqlo.com/UQ/ST3/id/imagesgoods/480167/item/idgoods_00_480167_3x4.jpg?width=369",
        "https://image.uniqlo.com/UQ/ST3/AsianCommon/imagesgoods/480167/sub/goods_480167_sub17_3x4.jpg?width=369",
        "https://image.uniqlo.com/UQ/ST3/AsianCommon/imagesgoods/480167/sub/goods_480167_sub18_3x4.jpg?width=369"
      ],
      "isPreorder": false,
      "preorderPeriod": 0,
      "isArchived": false,
      "insuranceRequired": false,
      "codEnabled": false,
      "warehouses": [
        {
          "clientId": "2026012714314318226016",
          "stock": 23
        }
      ]
    }
  ]
}

# Example Request

Curl Node.js Go Java

curl -X POST "http:///partner/stores/products/bulk" \
  -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":"bace66be-47c4-4f72-868c-ad792da8b210","name":"Ai Yazawa Short Sleeve UTX","description":"Comfortable cotton t-shirt, available in multiple colors.","sku":"480166","price":200000,"specialPrice":null,"stock":900,"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":["uniqlo","tshirt","Yazawa","japan","Unisex"],"condition":"NEW","photos":["https://image.uniqlo.com/UQ/ST3/id/imagesgoods/480166/item/idgoods_00_480166_3x4.jpg?width=369","https://image.uniqlo.com/UQ/ST3/AsianCommon/imagesgoods/480166/sub/goods_480166_sub14_3x4.jpg?width=369"],"isPreorder":false,"preorderPeriod":0,"isArchived":false,"insuranceRequired":true,"codEnabled":false},{"externalId":"52a3bcfb-62ea-4711-a4c1-b6847a981256","name":"Ai Yazawa Short Sleeve UTX","description":"Water-resistant backpack with laptop compartment.","sku":"480167","price":190000,"specialPrice":150000,"weight":800,"minOrder":1,"subCategoryId":"0e882586-c506-4792-a831-02767a6844e2","categoryId":"2fde2994-28a8-4d09-a128-6d744b9e1323","typeId":"d86db295-41c3-423d-a2c2-a59724f38316","hashtags":["tshirt","Yazawa","Japan"],"condition":"NEW","photos":["https://image.uniqlo.com/UQ/ST3/id/imagesgoods/480167/item/idgoods_00_480167_3x4.jpg?width=369","https://image.uniqlo.com/UQ/ST3/AsianCommon/imagesgoods/480167/sub/goods_480167_sub17_3x4.jpg?width=369","https://image.uniqlo.com/UQ/ST3/AsianCommon/imagesgoods/480167/sub/goods_480167_sub18_3x4.jpg?width=369"],"isPreorder":false,"preorderPeriod":0,"isArchived":false,"insuranceRequired":false,"codEnabled":false,"warehouses":[{"clientId":"2026012714314318226016","stock":23}]}]}'

const qs = new URLSearchParams({});
const url = "http:///partner/stores/products/bulk" + (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":"bace66be-47c4-4f72-868c-ad792da8b210","name":"Ai Yazawa Short Sleeve UTX","description":"Comfortable cotton t-shirt, available in multiple colors.","sku":"480166","price":200000,"specialPrice":null,"stock":900,"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":["uniqlo","tshirt","Yazawa","japan","Unisex"],"condition":"NEW","photos":["https://image.uniqlo.com/UQ/ST3/id/imagesgoods/480166/item/idgoods_00_480166_3x4.jpg?width=369","https://image.uniqlo.com/UQ/ST3/AsianCommon/imagesgoods/480166/sub/goods_480166_sub14_3x4.jpg?width=369"],"isPreorder":false,"preorderPeriod":0,"isArchived":false,"insuranceRequired":true,"codEnabled":false},{"externalId":"52a3bcfb-62ea-4711-a4c1-b6847a981256","name":"Ai Yazawa Short Sleeve UTX","description":"Water-resistant backpack with laptop compartment.","sku":"480167","price":190000,"specialPrice":150000,"weight":800,"minOrder":1,"subCategoryId":"0e882586-c506-4792-a831-02767a6844e2","categoryId":"2fde2994-28a8-4d09-a128-6d744b9e1323","typeId":"d86db295-41c3-423d-a2c2-a59724f38316","hashtags":["tshirt","Yazawa","Japan"],"condition":"NEW","photos":["https://image.uniqlo.com/UQ/ST3/id/imagesgoods/480167/item/idgoods_00_480167_3x4.jpg?width=369","https://image.uniqlo.com/UQ/ST3/AsianCommon/imagesgoods/480167/sub/goods_480167_sub17_3x4.jpg?width=369","https://image.uniqlo.com/UQ/ST3/AsianCommon/imagesgoods/480167/sub/goods_480167_sub18_3x4.jpg?width=369"],"isPreorder":false,"preorderPeriod":0,"isArchived":false,"insuranceRequired":false,"codEnabled":false,"warehouses":[{"clientId":"2026012714314318226016","stock":23}]}]})
});
const json = await res.json();
console.log(json);

qs := url.Values{}

u := "http:///partner/stores/products/bulk"
if q := qs.Encode(); q != "" { u = u + "?" + q }
req, _ := http.NewRequest("POST", u, bytes.NewBufferString("{\"products\":[{\"externalId\":\"bace66be-47c4-4f72-868c-ad792da8b210\",\"name\":\"Ai Yazawa Short Sleeve UTX\",\"description\":\"Comfortable cotton t-shirt, available in multiple colors.\",\"sku\":\"480166\",\"price\":200000,\"specialPrice\":null,\"stock\":900,\"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\":[\"uniqlo\",\"tshirt\",\"Yazawa\",\"japan\",\"Unisex\"],\"condition\":\"NEW\",\"photos\":[\"https://image.uniqlo.com/UQ/ST3/id/imagesgoods/480166/item/idgoods_00_480166_3x4.jpg?width=369\",\"https://image.uniqlo.com/UQ/ST3/AsianCommon/imagesgoods/480166/sub/goods_480166_sub14_3x4.jpg?width=369\"],\"isPreorder\":false,\"preorderPeriod\":0,\"isArchived\":false,\"insuranceRequired\":true,\"codEnabled\":false},{\"externalId\":\"52a3bcfb-62ea-4711-a4c1-b6847a981256\",\"name\":\"Ai Yazawa Short Sleeve UTX\",\"description\":\"Water-resistant backpack with laptop compartment.\",\"sku\":\"480167\",\"price\":190000,\"specialPrice\":150000,\"weight\":800,\"minOrder\":1,\"subCategoryId\":\"0e882586-c506-4792-a831-02767a6844e2\",\"categoryId\":\"2fde2994-28a8-4d09-a128-6d744b9e1323\",\"typeId\":\"d86db295-41c3-423d-a2c2-a59724f38316\",\"hashtags\":[\"tshirt\",\"Yazawa\",\"Japan\"],\"condition\":\"NEW\",\"photos\":[\"https://image.uniqlo.com/UQ/ST3/id/imagesgoods/480167/item/idgoods_00_480167_3x4.jpg?width=369\",\"https://image.uniqlo.com/UQ/ST3/AsianCommon/imagesgoods/480167/sub/goods_480167_sub17_3x4.jpg?width=369\",\"https://image.uniqlo.com/UQ/ST3/AsianCommon/imagesgoods/480167/sub/goods_480167_sub18_3x4.jpg?width=369\"],\"isPreorder\":false,\"preorderPeriod\":0,\"isArchived\":false,\"insuranceRequired\":false,\"codEnabled\":false,\"warehouses\":[{\"clientId\":\"2026012714314318226016\",\"stock\":23}]}]}"))
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/products/bulk"))
    .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\":\"bace66be-47c4-4f72-868c-ad792da8b210\",\"name\":\"Ai Yazawa Short Sleeve UTX\",\"description\":\"Comfortable cotton t-shirt, available in multiple colors.\",\"sku\":\"480166\",\"price\":200000,\"specialPrice\":null,\"stock\":900,\"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\":[\"uniqlo\",\"tshirt\",\"Yazawa\",\"japan\",\"Unisex\"],\"condition\":\"NEW\",\"photos\":[\"https://image.uniqlo.com/UQ/ST3/id/imagesgoods/480166/item/idgoods_00_480166_3x4.jpg?width=369\",\"https://image.uniqlo.com/UQ/ST3/AsianCommon/imagesgoods/480166/sub/goods_480166_sub14_3x4.jpg?width=369\"],\"isPreorder\":false,\"preorderPeriod\":0,\"isArchived\":false,\"insuranceRequired\":true,\"codEnabled\":false},{\"externalId\":\"52a3bcfb-62ea-4711-a4c1-b6847a981256\",\"name\":\"Ai Yazawa Short Sleeve UTX\",\"description\":\"Water-resistant backpack with laptop compartment.\",\"sku\":\"480167\",\"price\":190000,\"specialPrice\":150000,\"weight\":800,\"minOrder\":1,\"subCategoryId\":\"0e882586-c506-4792-a831-02767a6844e2\",\"categoryId\":\"2fde2994-28a8-4d09-a128-6d744b9e1323\",\"typeId\":\"d86db295-41c3-423d-a2c2-a59724f38316\",\"hashtags\":[\"tshirt\",\"Yazawa\",\"Japan\"],\"condition\":\"NEW\",\"photos\":[\"https://image.uniqlo.com/UQ/ST3/id/imagesgoods/480167/item/idgoods_00_480167_3x4.jpg?width=369\",\"https://image.uniqlo.com/UQ/ST3/AsianCommon/imagesgoods/480167/sub/goods_480167_sub17_3x4.jpg?width=369\",\"https://image.uniqlo.com/UQ/ST3/AsianCommon/imagesgoods/480167/sub/goods_480167_sub18_3x4.jpg?width=369\"],\"isPreorder\":false,\"preorderPeriod\":0,\"isArchived\":false,\"insuranceRequired\":false,\"codEnabled\":false,\"warehouses\":[{\"clientId\":\"2026012714314318226016\",\"stock\":23}]}]}"))
    .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": "Products processed",
  "requestId": "57e21bea-d7f8-4ff1-8d6b-022e9fe302d8",
  "meta": {
    "timestamp": "2026-02-04T20:36:22.887Z",
    "durationMs": 28,
    "dispatch": true
  },
  "data": {
    "batchId": "pb_c4c90be3-de55-4fb5-aeac-6b064a1cb9dd",
    "summary": {
      "total": 2,
      "failed": 1,
      "pending": 1
    },
    "acceptedRows": [
      {
        "rowIndex": 1,
        "externalId": "52a3bcfb-62ea-4711-a4c1-b6847a981256",
        "sku": "480167"
      }
    ],
    "errors": [
      {
        "code": "PRD_002",
        "message": "Product with this external ID already exists",
        "rowIndex": 0,
        "externalId": "bace66be-47c4-4f72-868c-ad792da8b210",
        "sku": "480166",
        "details": {
          "retryable": false
        }
      }
    ]
  }
}

400 Bad Request

{
  "success": false,
  "error": {
    "code": "AUTH_003",
    "message": "Expired or invalid timestamp",
    "details": {
      "timestamp": "2025-08-23T21:24:48.113Z",
      "hint": "Request timestamp must be within 300 seconds",
      "context": {
        "providedTimestamp": 1755983140094,
        "currentTime": 1755984288112,
        "ageSeconds": 1148
      }
    }
  },
  "requestId": "bffa45ac-6fd4-4f05-b607-2011f03c7f22"
}

403 Forbidden

{
  "success": false,
  "error": {
    "code": "AUTH_014",
    "message": "Access forbidden",
    "details": {
      "timestamp": "2025-08-23T21:06:04.345Z",
      "hint": "Store not found, access blocked, or invalid token",
      "context": {
        "storeClientId": "str_TGIxyboe7-Rz"
      }
    }
  },
  "requestId": "ad531908-7fa9-41ea-bcf8-76b6b9c95a05"
}

# Dictionary

None for this endpoint.

# Notes

None for this endpoint.