Create or update many
Read and write keySeller API v1 · Updated 7 November 2026
POSThttps://klodivo.com/api/v1/inventory/bulk
Up to 500 listings in one request, matched by your external_ref: an existing listing with that ref is updated, otherwise one is created. Each item has the fields of a listing. Limit: 10 of these requests a minute.
Authentication
API key in the header Authorization: Bearer kv_live_…. This call needs a Read and write key. Create keys under Your store → API.
Body application/json
| Field | Type | Description |
|---|---|---|
| items Required | array | Up to 500 listings, each with its own external_ref. |
Responses
Done. One result per item, in the same order; items that failed don't stop the others. See the example response with the request examples.
The body isn't {"items": [ … ]}.
{
"error": {
"code": "invalid_body",
"message": "Send {\"items\": [ … ]}, each with an external_ref."
}
}More than 500 items.
{
"error": {
"code": "too_many",
"message": "Up to 500 items per request."
}
}Every item failed; results says why for each.
{
"results": [
{
"index": 0,
"ok": false,
"external_ref": "B3-3001-red",
"errors": {
"price": "Enter a price above 0."
}
}
],
"created": 0,
"updated": 0,
"failed": 1
}Missing, unknown or revoked key.
{
"error": {
"code": "unauthorized",
"message": "This API key doesn't exist or was revoked."
}
}A Read only key, or the store is suspended or closed.
{
"error": {
"code": "read_only_key",
"message": "This is a read-only key. Create a read and write key to change anything."
}
}Too many requests. Wait the seconds in Retry-After.
{
"error": {
"code": "rate_limited",
"message": "Too many requests: up to 120 a minute per key. Try again in 12 s."
}
}Still stuck? Contact us; we reply within 2 business days.