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

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

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

cURL

curl --request POST \
  --url 'https://api.stateset.com/api/v1/wishlists/{id}/items' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "note": null,
  "product_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}'

200

{
  "created_at": "2026-07-24T12:00:00Z",
  "customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "is_public": true,
  "items": [
    {
      "added_at": "2026-07-24T12:00:00Z",
      "note": null,
      "product_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    }
  ],
  "name": "string",
  "updated_at": "2026-07-24T12:00:00Z"
}

Path parameters

id · string · required

Wishlist ID (UUID)

Request body

AddWishlistItemRequest

note · string,null

Optional note about the item.

product_id · string (uuid) · required

Product to add to the wishlist.

Responses

200 · WishlistResponse

Item added to wishlist

400 · ErrorBody

Invalid request

404 · ErrorBody

Wishlist not found

cURL

curl --request POST \
  --url 'https://api.stateset.com/api/v1/wishlists/{id}/items' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "note": null,
  "product_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}'

200

{
  "created_at": "2026-07-24T12:00:00Z",
  "customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "is_public": true,
  "items": [
    {
      "added_at": "2026-07-24T12:00:00Z",
      "note": null,
      "product_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    }
  ],
  "name": "string",
  "updated_at": "2026-07-24T12:00:00Z"
}