Skip to main content

addWishlistItem

Add an item to the wishlist. 🔐 This method requires authorization (or a guest context).

Description​

This method adds a single product to the wishlist of the current context - an authorized user or a guest (resolved via the x-guest-id header, see Guest mode). It returns a Promise that resolves to the updated IWishlistResponse object.

Users.addWishlistItem(

body*, body.productId*

);

Parameters schema​

Schema

body(required): IWishlistAddItem
Item to add. Example: { productId: 1 }

body.productId(required): number
Product identifier.
example: 1

Examples​

Minimal example​

const response = await Users.addWishlistItem({ productId: 1 });

Example response​

{
  "items": [
    {
      "productId": 1,
      "addedAt": "2026-05-30T10:00:00.000Z"
    }
  ],
  "total": 1
}

Response schema​

Schema: IWishlistResponse

items: IWishlistItem[]
Wishlist items.

items.productId: number
Product identifier.
example: 1

items.addedAt: string
ISO date when the item was added.
example: "2026-05-30T10:00:00.000Z"

total: number
Total number of items in the wishlist.
example: 3