## Create Watchlist

`WatchlistCreateWatchlistResponse v1().watchlist().createWatchlist(WatchlistCreateWatchlistParamsparams, RequestOptionsrequestOptions = RequestOptions.none())`

**post** `/v1/watchlists`

Create Watchlist

### Parameters

- `WatchlistCreateWatchlistParams params`

  - `String name`

    The desired watchlist name.

### Returns

- `class WatchlistCreateWatchlistResponse:`

  - `WatchlistEntry data`

    Represents a user watchlist.

    - `String id`

      The unique identifier for the watchlist.

    - `LocalDateTime createdAt`

      The timestamp when the watchlist was created.

    - `String name`

      The user-provided watchlist name.

### Example

```java
package com.clear_street.api.example;

import com.clear_street.api.client.ClearStreetClient;
import com.clear_street.api.client.okhttp.ClearStreetOkHttpClient;
import com.clear_street.api.models.v1.watchlist.WatchlistCreateWatchlistParams;
import com.clear_street.api.models.v1.watchlist.WatchlistCreateWatchlistResponse;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        ClearStreetClient client = ClearStreetOkHttpClient.builder()
            .fromEnv()
            .apiKey("My API Key")
            .build();

        WatchlistCreateWatchlistParams params = WatchlistCreateWatchlistParams.builder()
            .name("name")
            .build();
        WatchlistCreateWatchlistResponse response = client.v1().watchlist().createWatchlist(params);
    }
}
```

#### 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"
  }
}
```