Add a photo
Read and write keySeller API v1 · Updated 7 November 2026
POSThttps://klodivo.com/api/v1/inventory/{id}/photos
Adds a photo to a listing, as multipart/form-data in a field named photo: JPEG, PNG or WebP up to 12 MB, 12 photos per listing.
Authentication
API key in the header Authorization: Bearer kv_live_…. This call needs a Read and write key. Create keys under Your store → API.
Path parameters
| Name | Type | Description |
|---|---|---|
| id Required | integer | The listing's id (from GET /inventory). |
Body multipart/form-data
| Field | Type | Description |
|---|---|---|
| photo Required | file | The image (multipart/form-data). |
Responses
Added. The listing with its photos. See the example response with the request examples.
The listing already has 12 photos.
{
"error": {
"code": "too_many_photos",
"message": "Up to 12 photos per listing."
}
}Not an image we can use.
{
"error": {
"code": "invalid_photo",
"message": "Use a JPEG, PNG or WebP photo."
}
}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.