---
search:
  tags:
    - Wishlist
    - POST
seo:
  description: >-
    Add items to a wishlist. Send either product_ids OR… Reference for the POST
    /api/v1/{app_id}/wishlists/{id}/items endpoint in the Customers API.
sidebar:
  label: Add items to wishlist
  badge: POST
title: Add items to wishlist
type: openapi-operation
---
Add items to a wishlist. Send either product_ids OR variant_group_ids, not both.
- product_ids: save the whole product (variant_group_id will be null on the item).
- variant_group_ids: save a specific variant group; product_id is derived from the group.

`POST /api/v1/{app_id}/wishlists/{id}/items`

**Request body** (`application/json`, required)

Items to add

- `product_ids` (string[]) — Product IDs for product-level wishlist items. Mutually exclusive with variant\_group\_ids.
- `variant_group_ids` (string[]) — Variant group IDs for group-scoped wishlist items. Mutually exclusive with product\_ids. Product ID is derived from each group.

Request body example:

```json
{
  "product_ids": [
    "string"
  ],
  "variant_group_ids": [
    "string"
  ]
}
```

**Responses**

- `200` — Items added successfully
- `400` — Invalid request
- `401` — Unauthorized
- `404` — Wishlist not found
- `500` — Internal server error

Response example, 200:

```json
{
  "message": "string"
}
```