## Create Watchlist

`$ clear-street v1:watchlist create-watchlist`

**post** `/v1/watchlists`

Create Watchlist

### Parameters

- `--name: string`

  The desired watchlist name.

### Returns

- `V1WatchlistNewWatchlistResponse: BaseResponse`

  - `data: object { id, created_at, name }`

    Represents a user watchlist.

    - `id: string`

      The unique identifier for the watchlist.

    - `created_at: string`

      The timestamp when the watchlist was created.

    - `name: string`

      The user-provided watchlist name.

### Example

```cli
clear-street v1:watchlist create-watchlist \
  --api-key 'My API Key' \
  --name name
```

#### Response

```json
{
  "data": {
    "created_at": "2025-01-23T12:00:00.000000000Z",
    "id": "770e8400-e29b-41d4-a716-446655440002",
    "name": "Growth Stocks"
  },
  "error": null,
  "metadata": {
    "request_id": "b2c3d4e5-f6a7-8901-2345-678901bcdefg"
  }
}
```