Add items to wishlist
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}/itemsAuthorization
AuthorizationAPI key · headerrequiredBearer token (format: "Bearer {token}")
Path parameters
app_idstringrequiredUUID of the app
idstringrequiredUUID of the wishlist
Request body
requiredapplication/jsonItems to add
product_idsstring[]Product IDs for product-level wishlist items. Mutually exclusive with variant_group_ids.
variant_group_idsstring[]Variant group IDs for group-scoped wishlist items. Mutually exclusive with product_ids. Product ID is derived from each group.
Responses
200
Items added successfully
messagestring400
Invalid request
detailsstring[] | nullmessagestringsuccessboolean401
Unauthorized
detailsstring[] | nullmessagestringsuccessboolean404
Wishlist not found
detailsstring[] | nullmessagestringsuccessboolean500
Internal server error
detailsstring[] | nullmessagestringsuccessboolean