Batch upsert products

POST /products/batch on the WISEPIM Public API: create or update up to 200 products by SKU in one atomic, idempotent call. Requires products:write.

POST /api/public/v1/products/batch

Create or update up to 200 products by SKU

cURL

curl --request POST \
  --url https://wisepim.com/api/public/v1/products/batch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {
      "sku": "<string>",
      "ean": "<string>",
      "upc": "<string>",
      "manufacturer_part_number": "<string>",
      "brand": "<string>",
      "name": "<string>",
      "name_long": "<string>",
      "description": "<string>",
      "short_description": "<string>",
      "name_localized": {},
      "description_localized": {},
      "short_description_localized": {},
      "status": "<string>",
      "meta_title": "<string>",
      "meta_description": "<string>",
      "meta_keywords": "<string>",
      "price": "<string>",
      "special_price": "<string>",
      "special_price_start_date": "2023-11-07T05:31:56Z",
      "special_price_end_date": "2023-11-07T05:31:56Z",
      "category_ids": [
        123
      ],
      "attributes": {}
    }
  ]
}
'

200

{
  "results": [
    {
      "index": 123,
      "sku": "<string>",
      "id": 123,
      "action": "<string>"
    }
  ],
  "summary": {
    "created": 123,
    "updated": 123
  }
}

Authorizations

Authorization · string · header · required

Use a project API key from Settings > API Access. Send it as Authorization: Bearer wpk_.... See authentication and scopes for setup and permissions.

Headers

Idempotency-Key · string

Reuse this key for retries of the same write. Scoped to this API key; retained until key deletion. Different requests with the same key return 409.

Required string length: 1 - 128

Pattern: ^[!-~]+$

Body

application/json

items · ProductUpsertIn · object[] · required

Required array length: 1 - 200 elements

Show child attributes

Response

200

application/json

OK

results · BatchResultItemOut · object[] · required

Show child attributes

summary · BatchSummaryOut · object · required

Show child attributes