> For the complete documentation index, see [llms.txt](https://the-wishlist-documentation.gitbook.io/the-wishlist-documentation-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://the-wishlist-documentation.gitbook.io/the-wishlist-documentation-docs/wishlist-rest-api/wishlist-items/additems.md).

# addItems

Add multiple items to an existing wishlist. Please provide either wishlist ***id*** or ***wishlistRef***.

```json
{"openapi":"3.0.3","info":{"title":"Wishlist REST API","version":"0.0.1"},"tags":[{"name":"wishlist-items","description":"Add, update, remove and query the items on a wishlist."}],"servers":[{"url":"https://api.au-aws.thewishlist.io/services/wsservice"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","description":"OAuth2 bearer token issued by TWC Keycloak, sent as `Bearer <token>`."}},"parameters":{"wishlistId":{"name":"WishlistId","in":"query","required":false,"description":"TWC's unique identifier for a wishlist","schema":{"type":"string"}},"wishlistRef":{"name":"wishlistRef","in":"query","required":false,"description":"The retailer's unique identifier for a wishlist.  Implementations typically use the TWC unique identifier rather than this parameter.","schema":{"type":"string"}},"X-TWC-Tenant-2":{"name":"X-TWC-Tenant","in":"header","required":false,"description":"tenant-key (your retail store's unique identifier in TWC)","schema":{"type":"string"}}}},"paths":{"/api/wishlist/add-items":{"post":{"summary":"addItems","operationId":"addItemsUsingPOST","parameters":[{"$ref":"#/components/parameters/wishlistId"},{"$ref":"#/components/parameters/wishlistRef"},{"$ref":"#/components/parameters/X-TWC-Tenant-2"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"itemId":{"type":"array","items":{"type":"object","properties":{"addedByStaff":{"type":"boolean"},"addedFromCart":{"type":"boolean"},"attributeGroups":{"type":"object","properties":{"property1":{"type":"object","properties":{"attributes":{"type":"object","properties":{"property1":{"type":"string"},"property2":{"type":"string"}}},"description":{"type":"string"}}},"property2":{"type":"object","properties":{"attributes":{"type":"object","properties":{"property1":{"type":"string"},"property2":{"type":"string"}}},"description":{"type":"string"}}}}},"disableNotification":{"type":"boolean"},"locationId":{"type":"string"},"locationRef":{"type":"string"},"notifyMe":{"type":"boolean"},"prerelease":{"type":"boolean"},"productId":{"type":"string"},"purchasedAndRemoved":{"type":"boolean"},"selectedVariantId":{"type":"string"},"staffRef":{"type":"string"},"wishlistItemRef":{"type":"string"}}}},"itemRef":{"type":"array","items":{"type":"object","properties":{"addedByStaff":{"type":"boolean"},"addedFromCart":{"type":"boolean"},"attributeGroups":{"type":"object","properties":{"property1":{"type":"object","properties":{"attributes":{"type":"object","properties":{"property1":{"type":"string"},"property2":{"type":"string"}}},"description":{"type":"string"}}},"property2":{"type":"object","properties":{"attributes":{"type":"object","properties":{"property1":{"type":"string"},"property2":{"type":"string"}}},"description":{"type":"string"}}}}},"disableNotification":{"type":"boolean"},"locationId":{"type":"string"},"locationRef":{"type":"string"},"notifyMe":{"type":"boolean"},"prerelease":{"type":"boolean"},"productRef":{"type":"string"},"purchasedAndRemoved":{"type":"boolean"},"selectedVariantRef":{"type":"string"},"staffRef":{"type":"string"},"wishlistItemRef":{"type":"string"}}}},"wishlistId":{"type":"string"},"wishlistRef":{"type":"string"}}}}},"description":"items","required":true},"responses":{"200":{"description":"OK"},"201":{"description":"Created"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"deprecated":false,"description":"Add multiple items to an existing wishlist. Please provide either wishlist ***id*** or ***wishlistRef***.","tags":["wishlist-items"]}}}}
```