Add one or more items to a wishlist for the authenticated user

API ownership

• API family: Auth API
• Best for: Customer identity, session, token, cart, and wishlist flows.
• Do not use from: Merchant admin data syncs or public catalog rendering.
• Guide route: /apis/auth/latest

The OpenAPI contract defines the method, path, parameters, request body, and responses for this operation.

Operation

• Method: POST
• Path: /api/v1/\{app_id\}/wishlists/\{id\}/items
• Summary: Add items to wishlist
• Description: Add one or more items to a wishlist for the authenticated user
• OpenAPI contract: auth-api
• Operation ID: Not documented in the OpenAPI contract.

Operation key uses API family, method, and path because this OpenAPI contract does not publish an operation ID.

{
  "product_ids": [
    "string"
  ]
}

{
  "message": "string"
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": false
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": false
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": false
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": false
}

Contract identity

Use these fields to confirm you are implementing the intended endpoint contract.

• API family: Auth API
• Method: POST
• Path: /api/v1/\{app_id\}/wishlists/\{id\}/items
• Operation ID: Not documented in the OpenAPI contract.
• OpenAPI tag: Wishlist
• OpenAPI summary: Add items to wishlist