post
https://{subdomain}.myshoplaza.com/openapi/2025-06/products//images
Create a new product image with the provided details.
Requireswrite_productaccess scope. More access scope
The Create Product Image APIallows users to upload and associate a new image with a specific product by providing the product's ID and image details. This API ensures efficient management of product images, enabling users to specify image attributes like dimensions, position, and alternative text.This API is especially useful for:
- Upload new images for products to enhance their display and marketing.
- Specify image attributes such as width, height, position, and alternative text for better presentation.
Note: The operation is scoped to a specific shop, identified by its unique domain prefix (shopdomain), ensuring all updates are applied to the correct store.
Request Parameters
Public Request Parameters
Path Parameters
| Parameter | Type | Required | Example | Description |
|---|---|---|---|---|
product_id | string | Yes | 9fb9f3c6-2300-42c1-8593-d9008d7cfc09 | The unique identifier for the product. |
Body Parameters
| Parameter | Type | Required | Example | Description |
|---|---|---|---|---|
code |
string |
Yes | 'Success' | Response status |
data |
string |
Yes | Data Object | |
data.image |
object |
Yes | Image Object | |
data.image.src |
string |
Yes | "http://cdn.shoplazza.com/1.jpg" |
The URL of the image. Must be a valid URL. |
data.image.position |
string |
No | "1" |
The position of the image relative to other images. Must be greater than 0. |
data.image.alt |
string |
No | "Product front view" |
Alternative text for the image (used for accessibility or descriptions). |
data.mage.width |
int |
No | 300 |
The width of the image in pixels. Must be greater than 0. |
data.image.height |
int |
No | 300 |
The height of the image in pixels. Must be greater than 0. |
Response Explanation
Public Response Parameters
Success Response
| Field | Type | Example | Description |
|---|---|---|---|
image.id |
string |
91d032e7-bbc8-47e4-8668-9ba6fe714de6 |
The unique identifier for the image. |
image.product_id |
string |
636a07da-39eb-4829-bde9-b65fae1c28b0 |
The unique identifier for the product associated with the image. |
image.position |
integer |
1 |
The position of the image relative to other images in the product gallery. |
image.src |
string |
//cdn.shoplazza.com/efd33b921cacd5311a32dd03a9bc8740.png | The URL of the image. |
image.width |
integer |
1588 |
The width of the image in pixels. |
image.height |
integer |
2246 |
The height of the image in pixels. |
image.alt |
string |
"" |
Alternative text for the image (used for accessibility or descriptions). |
image.created_at |
string |
2024-04-08T07:13:28Z |
The timestamp indicating when the image was created. |
image.updated_at |
string |
2024-04-08T07:13:28Z |
The timestamp indicating when the image was last updated. |
Error Response
| Field | Type | Example | Description |
|---|---|---|---|
code | string | InvalidParameter | Error http message |
message | string | `` | Error message |