---
title: Watchlists | Clear Street
description: Create, populate, review, and delete watchlists of instruments.
---

Watchlists let users save and organize groups of instruments for quick reference. Each user can maintain multiple watchlists, and each can hold up to 1,000 instruments.

## Recommended Client Flow for Watchlist

1. You can create your first watchlist by using the [create watchlist endpoint](https://docs.clearstreet.com/api/resources/v1/subresources/watchlists/methods/create_watchlist) `POST v1/watchlists` and providing a name
   1. Once that is done you can confirm the watchlist was created by taking the watchlist\_id from the POST call and checking the [get watchlist by id endpoint](https://docs.clearstreet.com/api/resources/v1/subresources/watchlists/methods/get_watchlist_by_id) `GET /v1/watchlists/{watchlist_id}`
2. Now it’s time to populate the watchlist by using the [add watchlist item endpoint](https://docs.clearstreet.com/api/resources/v1/subresources/watchlists/subresources/items/methods/add_watchlist_item) `POST /v1/watchlists/{watchlist_id}/items` . In the body of the post request you will pass an instrument\_id.
   1. Remove unwanted items with the [delete watchlist item endpoint](https://docs.clearstreet.com/api/resources/v1/subresources/watchlists/subresources/items/methods/delete_watchlist_item) `DELETE /v1/watchlists/{watchlist_id}/items/{item_id}` to remove it. The item\_id will be returned when you made the previous post call or if you are looking to remove it at a later point in time you can use the get watchlist endpoint in step 1.a to get the same item\_id
3. Additionally if you decide you do not want to keep a watchlist altogether you cycle through the different watchlists you have created by using [get watchlist endpoint](https://docs.clearstreet.com/api/resources/v1/subresources/watchlists/methods/get_watchlists) `GET /v1/watchlists` and use the watchlist\_id that you retrieved and pass it to [delete watchlist endpoint](https://docs.clearstreet.com/api/resources/v1/subresources/watchlists/methods/delete_watchlist) `DELETE /v1/watchlists/{watchlist_id}`

---