Create and Enrich Product

curl --request POST \
  --url https://omnicommerce.sg/api/v1/products \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "product": {
    "id": "cml55mqcq06vwo20ialgr54ry",
    "sku": "TZVBGTB82269",
    "sku_tpp": "TZVBGTB82269",
    "sku_ori": "63074830",
    "title": "Navy Blue Leather Tote and Crossbody Bag",
    "brand": "ZADIG & VOLTAIRE",
    "status": "ACTIVE",
    "price": "600",
    "compare_at_price": "720",
    "cost_per_item": "425.4",
    "description": "Gender: Women Brand: ZADIG & VOLTAIRE Product Name: Zadig & Voltaire Navy Blue Leather Tote and Crossbody Bag Condition: A Color: navy blue Material: lamb leather Origin: Tunisia Includes: dust bag",
    "images": "https://api.example.com/images/1.jpg | https://api.example.com/images/2.jpg",
    "category": "BAGS",
    "category_name": "SHOULDER BAGS",
    "color": "BLUE",
    "condition": "GOOD",
    "gender": "WOMEN",
    "material": "LEATHER",
    "inventory": "1",
    "dimensions": "Length 17cm x Height 11cm x Width 9cm",
    "weight": 450,
    "product_type": "SHOULDER BAGS"
  }
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    product: {
      id: 'cml55mqcq06vwo20ialgr54ry',
      sku: 'TZVBGTB82269',
      sku_tpp: 'TZVBGTB82269',
      sku_ori: '63074830',
      title: 'Navy Blue Leather Tote and Crossbody Bag',
      brand: 'ZADIG & VOLTAIRE',
      status: 'ACTIVE',
      price: '600',
      compare_at_price: '720',
      cost_per_item: '425.4',
      description: 'Gender: Women Brand: ZADIG & VOLTAIRE Product Name: Zadig & Voltaire Navy Blue Leather Tote and Crossbody Bag Condition: A Color: navy blue Material: lamb leather Origin: Tunisia Includes: dust bag',
      images: 'https://api.example.com/images/1.jpg | https://api.example.com/images/2.jpg',
      category: 'BAGS',
      category_name: 'SHOULDER BAGS',
      color: 'BLUE',
      condition: 'GOOD',
      gender: 'WOMEN',
      material: 'LEATHER',
      inventory: '1',
      dimensions: 'Length 17cm x Height 11cm x Width 9cm',
      weight: 450,
      product_type: 'SHOULDER BAGS'
    }
  })
};

fetch('https://omnicommerce.sg/api/v1/products', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://omnicommerce.sg/api/v1/products"

payload = { "product": {
        "id": "cml55mqcq06vwo20ialgr54ry",
        "sku": "TZVBGTB82269",
        "sku_tpp": "TZVBGTB82269",
        "sku_ori": "63074830",
        "title": "Navy Blue Leather Tote and Crossbody Bag",
        "brand": "ZADIG & VOLTAIRE",
        "status": "ACTIVE",
        "price": "600",
        "compare_at_price": "720",
        "cost_per_item": "425.4",
        "description": "Gender: Women Brand: ZADIG & VOLTAIRE Product Name: Zadig & Voltaire Navy Blue Leather Tote and Crossbody Bag Condition: A Color: navy blue Material: lamb leather Origin: Tunisia Includes: dust bag",
        "images": "https://api.example.com/images/1.jpg | https://api.example.com/images/2.jpg",
        "category": "BAGS",
        "category_name": "SHOULDER BAGS",
        "color": "BLUE",
        "condition": "GOOD",
        "gender": "WOMEN",
        "material": "LEATHER",
        "inventory": "1",
        "dimensions": "Length 17cm x Height 11cm x Width 9cm",
        "weight": 450,
        "product_type": "SHOULDER BAGS"
    } }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "ok": true,
  "apiVersion": "developer_v1",
  "operationId": "<string>",
  "status": "<string>",
  "jobId": "<string>",
  "warnings": [
    "<string>"
  ],
  "recommendations": [
    "<string>"
  ],
  "links": {},
  "data": {
    "normalizedInput": {},
    "issues": [
      {}
    ],
    "targetMarketplaces": [
      "<string>"
    ],
    "targetCountries": [
      "<string>"
    ]
  }
}

Products

Create and Enrich Product

Queue a single-product create/enrich workflow for the authenticated organization. The request mirrors bulk product import for one product: product contains developer-supplied fields, arbitrary extra fields are preserved for enrichment context, SKU is the unique upsert identifier, externally hosted HTTP(S) images are mirrored to managed R2 storage, and the API returns a job ID to poll with GET /api/v1/jobs/. targetMarketplaces and targetCountries are optional; product creation and enrichment can run without marketplace publishing targets.

POST

api

products

curl --request POST \
  --url https://omnicommerce.sg/api/v1/products \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "product": {
    "id": "cml55mqcq06vwo20ialgr54ry",
    "sku": "TZVBGTB82269",
    "sku_tpp": "TZVBGTB82269",
    "sku_ori": "63074830",
    "title": "Navy Blue Leather Tote and Crossbody Bag",
    "brand": "ZADIG & VOLTAIRE",
    "status": "ACTIVE",
    "price": "600",
    "compare_at_price": "720",
    "cost_per_item": "425.4",
    "description": "Gender: Women Brand: ZADIG & VOLTAIRE Product Name: Zadig & Voltaire Navy Blue Leather Tote and Crossbody Bag Condition: A Color: navy blue Material: lamb leather Origin: Tunisia Includes: dust bag",
    "images": "https://api.example.com/images/1.jpg | https://api.example.com/images/2.jpg",
    "category": "BAGS",
    "category_name": "SHOULDER BAGS",
    "color": "BLUE",
    "condition": "GOOD",
    "gender": "WOMEN",
    "material": "LEATHER",
    "inventory": "1",
    "dimensions": "Length 17cm x Height 11cm x Width 9cm",
    "weight": 450,
    "product_type": "SHOULDER BAGS"
  }
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    product: {
      id: 'cml55mqcq06vwo20ialgr54ry',
      sku: 'TZVBGTB82269',
      sku_tpp: 'TZVBGTB82269',
      sku_ori: '63074830',
      title: 'Navy Blue Leather Tote and Crossbody Bag',
      brand: 'ZADIG & VOLTAIRE',
      status: 'ACTIVE',
      price: '600',
      compare_at_price: '720',
      cost_per_item: '425.4',
      description: 'Gender: Women Brand: ZADIG & VOLTAIRE Product Name: Zadig & Voltaire Navy Blue Leather Tote and Crossbody Bag Condition: A Color: navy blue Material: lamb leather Origin: Tunisia Includes: dust bag',
      images: 'https://api.example.com/images/1.jpg | https://api.example.com/images/2.jpg',
      category: 'BAGS',
      category_name: 'SHOULDER BAGS',
      color: 'BLUE',
      condition: 'GOOD',
      gender: 'WOMEN',
      material: 'LEATHER',
      inventory: '1',
      dimensions: 'Length 17cm x Height 11cm x Width 9cm',
      weight: 450,
      product_type: 'SHOULDER BAGS'
    }
  })
};

fetch('https://omnicommerce.sg/api/v1/products', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://omnicommerce.sg/api/v1/products"

payload = { "product": {
        "id": "cml55mqcq06vwo20ialgr54ry",
        "sku": "TZVBGTB82269",
        "sku_tpp": "TZVBGTB82269",
        "sku_ori": "63074830",
        "title": "Navy Blue Leather Tote and Crossbody Bag",
        "brand": "ZADIG & VOLTAIRE",
        "status": "ACTIVE",
        "price": "600",
        "compare_at_price": "720",
        "cost_per_item": "425.4",
        "description": "Gender: Women Brand: ZADIG & VOLTAIRE Product Name: Zadig & Voltaire Navy Blue Leather Tote and Crossbody Bag Condition: A Color: navy blue Material: lamb leather Origin: Tunisia Includes: dust bag",
        "images": "https://api.example.com/images/1.jpg | https://api.example.com/images/2.jpg",
        "category": "BAGS",
        "category_name": "SHOULDER BAGS",
        "color": "BLUE",
        "condition": "GOOD",
        "gender": "WOMEN",
        "material": "LEATHER",
        "inventory": "1",
        "dimensions": "Length 17cm x Height 11cm x Width 9cm",
        "weight": 450,
        "product_type": "SHOULDER BAGS"
    } }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "ok": true,
  "apiVersion": "developer_v1",
  "operationId": "<string>",
  "status": "<string>",
  "jobId": "<string>",
  "warnings": [
    "<string>"
  ],
  "recommendations": [
    "<string>"
  ],
  "links": {},
  "data": {
    "normalizedInput": {},
    "issues": [
      {}
    ],
    "targetMarketplaces": [
      "<string>"
    ],
    "targetCountries": [
      "<string>"
    ]
  }
}

Authorizations

Authorization

string

header

required

Bearer API key for server-to-server access. Session auth is also supported in first-party UI flows.

Body

application/json

product

object

required

Single product payload. sku and title are required for create/upsert. Known fields are normalized; arbitrary extra fields are preserved and passed to enrichment.

Show child attributes

variants

object[]

Optional variant rows to create under the root product. Arbitrary variant fields are accepted; variationAttributes or attributes are normalized when present.

Show child attributes

variationSchema

object

Optional variation schema, e.g. { "color": ["BLUE", "BLACK"] }.

Show child attributes

targetMarketplaces

enum<string>[]

Optional marketplace targets. Product creation/enrichment works when omitted.

Available options:

shopee,

lazada,

tiktok,

shopify,

zalora,

amazon

targetCountries

string[]

Optional target country hints for marketplace/GEO workflows.

model

string

Optional enrichment model override.

additionalInstructions

string

Optional instructions applied to LLM enrichment and image handling. For example, exclude images tagged as size charts, maps, or cluttered supplier feed shots.

Maximum string length: 4000

workflow

object

Optional workflow switches.

Show child attributes

Response

Product create/enrich workflow accepted

boolean

apiVersion

string

default:developer_v1

operationId

string

status

string

jobId

string

warnings

string[]

recommendations

string[]

links

object

Show child attributes

data

object

Show child attributes

Overview

Endpoints

Create and Enrich Product

Authorizations

Body

Response