Access to individual endpoints can be restricted per account. If a request to this endpoint returns
403 with error code endpoint_not_enabled and you expect to have access, contact your account representative.POST /v1/products/lists to create a new product list. Provide a name, one or more product IDs, and any metadata key:value pairs you want to associate with the list. The response returns the new list ID together with full product objects for every product you included.
Request
Endpoint:POST /v1/products/lists
Headers
Body parameters
A display name for the list. Use something meaningful to your application — for example,
"Smart Home Devices" or "Summer Campaign Q3".An array of product ID strings to include in the list. Product IDs come from the Products API search results.
Up to 16 key:value string pairs you can use to label and query this list. Keys are max 64 characters; values are max 512 characters.
Example request
cURL
Response
A201 Created response contains a data object with the new list and full product details, plus a meta object with a trace ID.
Response fields
Product object fields
Each item indata.products contains the following fields.