Add / Update Product

post

https://distillery.pixlee.co/api/v2/albums/

Creates or updates a product album.

Create vs update

Create: Requires product object with sku, name, product_photo, and buy_now_link_url fields.
Update: Requires product object with either sku, native_product_id, or pixlee_product_id to identify the product. Partial updates are supported (for example stock-only updates from integrations).
Multi-region: Add regional_info array to product. Add an object per-region to the array with regional values. Each region entry requires name and buy_now_link_url. New regions also require region_code and currency.

For standard or category albums, use Create Album.

Authentication details: About the Content API.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Creates or updates a product album (album_type: product).

title

string

required

Album title. Required.

album_type

string

enum

Defaults to product

Must be product for this endpoint.

Allowed:

live_update

boolean

Defaults to false

public_contribution

boolean

Defaults to true

moderation

boolean

Defaults to true

When true, new content goes to the album inbox for review.

num_photos

integer

Defaults to 0

num_inbox_photos

integer

Defaults to 0

restricted_access

boolean

Defaults to false

users_with_access

array of integers

User ids allowed to access a restricted album.

users_with_access

product

object

required

Product fields nested under the album. On create, sku, name, product_photo, and buy_now_link_url are required. On update, the product is matched by sku, native_product_id, or pixlee_product_id.

Responses

200Product album created or updated.

400Invalid product payload, missing required fields, duplicate key, or invalid signature.