Batch upsert products by SKU

POST /rest/v1/products/batch

Create or update up to 100 products in one call, matched by variant SKU. Items are validated upfront; per-item outcomes appear in the operation's results[] and the overall status may be partial.

Authorization

apiKey

AuthorizationBearer <token>

Authorization: Bearer nbl_live_... (or nbl_test_... for test mode). Test-mode writes are validated and simulated but never persisted and never touch channels; simulated results are marked simulated.

In: header

Header Parameters

Idempotency-Key?string

Unique client-generated key (max 255 chars), stored 24h.

Lengthlength <= 255

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

items*array<>

Items1 <= items <= 100

Response Body

`application/json`

curl -X POST "https://example.com/products/batch" \  -H "Content-Type: application/json" \  -d '{    "items": [      {        "title": "string"      }    ]  }'

{  "id": "op_8fd2c1",  "object": "operation",  "type": "string",  "status": "pending",  "resource_type": "string",  "resource_id": "string",  "results": [    {      "channel_account_id": "string",      "listing_id": "string",      "sku": "string",      "status": "pending",      "error": {        "code": "string",        "message": "string"      }    }  ],  "created_at": "2019-08-24T14:15:22Z",  "completed_at": "2019-08-24T14:15:22Z"}

Last updated on July 28, 2026

Need help?

The API is in private beta — email us and a human replies, usually within one business day.

Email us API status

Authorization

Header Parameters

Request Body

Response Body

202application/json

422application/json

`application/json`

`application/json`