Wishlist Items
Add, remove, list, and check wishlist items.
All item endpoints require an identity with at least customerId or sessionId.
customerId is the numeric Shopify customer id as a string.
Authentication is required.
Identity object
{
"customerId": "8769049329896",
"sessionId": "guest-session-id",
"email": "customer@example.com",
"firstName": "Jane",
"lastName": "Doe",
"device": "desktop",
"locale": "en"
}Send null for fields you do not use. At least one of customerId or sessionId is required.
Add item
POST /item/add
Request
{
"identity": {
"customerId": "8769049329896",
"sessionId": null,
"email": "customer@example.com",
"firstName": "Jane",
"lastName": "Doe",
"device": "desktop",
"locale": "en"
},
"productId": "gid://shopify/Product/1",
"variantId": null,
"productTitle": "Sunglasses",
"variantTitle": null,
"productHandle": "sunglasses",
"image": "https://cdn.example.com/image.jpg",
"price": "49.00",
"compareAt": "69.00",
"currencyCode": "USD",
"countryCode": "US",
"inventoryAvailable": true,
"properties": { "custom": "value" },
"quantity": 1,
"source": "pdp"
}Response
{
"profileId": "cuid...",
"itemId": "cuid...",
"productId": "gid://shopify/Product/1",
"variantId": null,
"quantity": 1
}Remove item
POST /item/remove
Request
{
"identity": {
"customerId": "8769049329896",
"sessionId": null,
"device": "desktop",
"firstName": null,
"lastName": null,
"locale": "en"
},
"productId": "gid://shopify/Product/1",
"variantId": null,
"event": null
}Response
{
"profileId": "cuid...",
"removed": true,
"productId": "gid://shopify/Product/1",
"variantId": null
}List items
POST /item/list
Request
{
"identity": {
"customerId": "8769049329896",
"sessionId": null,
"device": "desktop",
"firstName": null,
"lastName": null,
"locale": "en"
}
}Response
{
"profileId": "cuid...",
"items": [
{
"id": "cuid...",
"profileId": "cuid...",
"shop": "example.myshopify.com",
"productId": "gid://shopify/Product/1",
"variantId": null,
"productTitle": "Sunglasses",
"variantTitle": null,
"productHandle": "sunglasses",
"image": "https://cdn.example.com/image.jpg",
"price": "49.00",
"compareAt": "69.00",
"properties": { "custom": "value" },
"quantity": 1,
"source": "pdp",
"lastInventory": null,
"lastPriceDropNotifiedPrice": null,
"lastPriceDropNotifiedAt": null,
"lastBackInStockNotifiedAt": null,
"lastLowStockNotifiedAt": null,
"addedAt": "2026-02-07T10:00:00.000Z",
"updatedAt": "2026-02-07T10:00:00.000Z"
}
]
}Item status
POST /item/status
Request
{
"identity": {
"customerId": "8769049329896",
"sessionId": null,
"device": "desktop",
"firstName": null,
"lastName": null,
"locale": "en"
},
"productId": "gid://shopify/Product/1",
"variantId": null,
"includePublicCount": true
}Response
{
"profileId": "cuid...",
"exists": true,
"publicCount": 24
}