POST

Add Product Media

Adds media items to a specified product, either via URL or existing media ID.

Authentication

You can only call this method when authenticated as a Wix app or Wix user identity.

Permissions
Manage Stores - all permissions
Manage Products
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/stores/v1/products/{id}/media
Path Params
idstringRequired

Product ID.

Body Params
mediaArray <MediaDataForWrite>minItems 1maxItems 50

Sources of media items already uploaded to the Wix site.

Response Object
Returns an empty object.
Add Product Media Example 1
Request
cURL
curl -X POST \
   'https://www.wixapis.com/stores/v1/products/1044e7e4-37d1-0705-c5b3-623baae212fd/media' \
    --data-binary '{
                     "media": [
                       {
                         "mediaId": "9cc22d8b8d5244aba9ed73fb1783fc26.jpg"
                       },
                       {
                         "url": "https://your-site-url/image.jpeg",
                         "choice": {
                            "option": "Color",
                            "choice": "Blue"
                         }
                       },
                       {
                         "mediaId": "11062b_382eeb350464462c8f9150e4d3e40f2b"
                       }
                     ]
                   }' \
   -H 'Content-Type: application/json' \
   -H 'Authorization: <AUTH>'
Response
JSON
{}
Errors

This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Did this help?