curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.stateset.com/api/v1/wishlists/{id}/items' \
--header "Authorization: Bearer $STATESET_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"note": "Two-person tent, green — replacement for damaged pole set.",
"product_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}'
{
"created_at": "2026-08-31T14:22:05Z",
"customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"is_public": true,
"items": [
{
"added_at": "2026-08-31T14:22:05Z",
"note": "Two-person tent, green — replacement for damaged pole set.",
"product_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
],
"name": "Two-Person Tent",
"updated_at": "2026-08-31T14:22:05Z"
}
Add an item (/api/v1/wishlists/{id}/items)
Item added to wishlist
POST
/
api
/
v1
/
wishlists
/
{id}
/
items
curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.stateset.com/api/v1/wishlists/{id}/items' \
--header "Authorization: Bearer $STATESET_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"note": "Two-person tent, green — replacement for damaged pole set.",
"product_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}'
{
"created_at": "2026-08-31T14:22:05Z",
"customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"is_public": true,
"items": [
{
"added_at": "2026-08-31T14:22:05Z",
"note": "Two-person tent, green — replacement for damaged pole set.",
"product_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
],
"name": "Two-Person Tent",
"updated_at": "2026-08-31T14:22:05Z"
}
Confirm your deployment before running this request. This page describes an API contract;
a published reference does not establish hosted availability. Check the dated
host report and obtain your deployment URL and credentials.
Replace the example host if your provisioned service uses a different URL.
Path parameters
string
required
Wishlist ID (UUID)
Request body
AddWishlistItemRequest
string,null
Optional note about the item.
string (uuid)
required
Product to add to the wishlist.
Response
WishlistResponse
string (date-time)
required
string (uuid)
required
string (uuid)
required
boolean
required
WishlistItemResponse[]
required
string
required
string (date-time)
required
Status codes
| Code | Meaning |
|---|---|
200 | Item added to wishlist |
400 | Invalid request |
404 | Wishlist not found |
Using this contract
Read the source OpenAPI document for declared schemas and alternatives. This page also includes documented corrections from the spec overlays. Example IDs and values are illustrative; replace them with records from your workspace.curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.stateset.com/api/v1/wishlists/{id}/items' \
--header "Authorization: Bearer $STATESET_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"note": "Two-person tent, green — replacement for damaged pole set.",
"product_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}'
{
"created_at": "2026-08-31T14:22:05Z",
"customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"is_public": true,
"items": [
{
"added_at": "2026-08-31T14:22:05Z",
"note": "Two-person tent, green — replacement for damaged pole set.",
"product_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
],
"name": "Two-Person Tent",
"updated_at": "2026-08-31T14:22:05Z"
}
Last modified on September 21, 2026