Upload main product image (async)

POST https://app.ecwid.com/api/v3/{storeId}/products/{productId}/image/async

Required access scopes

Your app must have the following access scopes to make this request: update_catalog

Path params

All path params are required.

Param	Type	Description
storeId	number	Ecwid store ID.
productId	number	Internal product ID.

Headers

The Authorization header is required.

Header	Format	Description
Authorization	Bearer secret_ab***cd	Access token of the application.

Request JSON

A JSON object with the following fields:

Field	Type	Description
url	string	HTTPS link to the image file that will be uploaded to the store. Required
width	string	Width of the image. Required
height	string	Height of the image. Required
externalId	string	Internal image ID for Lightspeed R-Series/X-Series image sync.
alt	object alt	Information about the image alt text.

alt

Field	Type	Description
main	string	Image alt text in the main store language.
translated	object translated	Image alt text translations.

translated

Object with text field translations in the "lang": "text" format, where the "lang" is an ISO 639-1 language code. For example:

{
    "en": "Sample text",
    "nl": "Voorbeeldtekst"
}

Translations are available for all active store languages. Only the default language translations are returned if no other translations are provided for the field. Find active store languages with GET /profile request > languages > enabledLanguages.

Response JSON

A JSON object with the following fields:

Field	Type	Description
id	number	Internal ID of the uploaded image.