Product List Items

A Product List is a collection of List Items. Each item references either a product from the Omneo product catalogue or a custom user-defined product.

Adding an item from the Omneo product catalogue

Provide at least one product identifier (product_variant_id, product_id, product_variant_sku, product_variant_barcode, or external_id):

curl -X POST https://api.[tenant].getomneo.com/api/v3/profiles/{profileId}/lists/{listId}/items \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "product_variant_id": 333729,
    "quantity": 1,
    "position": 1
  }'

To include quantity, the List Definition must have allow_quantity: true.

Adding items when creating a list

Items can be included inline in the list creation payload:

{
  "name": "Birthday Wishlist",
  "list_definition_id": 3,
  "items": [
    {
      "product_variant_id": 333729,
      "quantity": 1,
      "position": 1
    }
  ]
}

Adding a custom product item

If the List Definition has allow_custom_product: true, you can add items not in the Omneo product catalogue:

curl -X POST https://api.[tenant].getomneo.com/api/v3/profiles/{profileId}/lists/{listId}/custom \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Vintage Chanel Bag",
    "description": "Seen at the vintage market",
    "price": 450.00,
    "currency": "AUD",
    "url": "https://example.com/item",
    "image_url": "https://example.com/item.jpg",
    "quantity": 1
  }'

Removing a list item

DELETE /api/v3/profiles/{profileId}/lists/{listId}/items/{itemId}

Updating item position or quantity

Update is done on the list level. Include the item’s id in the items array of a PUT request to the list:

curl -X PUT https://api.[tenant].getomneo.com/api/v3/profiles/{profileId}/lists/{listId} \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "id": "item-uuid", "quantity": 2, "position": 1 }
    ]
  }'

List Reservations Working with Groups

⌘I

Core setup

Profiles and data

Commerce

Incentives

Reactions

Webhooks and events

Frontend & SDK

POS integration

Appointments

Lists

Groups

Feedback

Extensions

Product List Items

Adding an item from the Omneo product catalogue

Adding items when creating a list

Adding a custom product item

Removing a list item

Updating item position or quantity

​Adding an item from the Omneo product catalogue

​Adding items when creating a list

​Adding a custom product item

​Removing a list item

​Updating item position or quantity

Adding an item from the Omneo product catalogue

Adding items when creating a list

Adding a custom product item

Removing a list item

Updating item position or quantity