---
title: "Create A Watchlist"
method: POST
path: "/iserver/watchlist"
tags: ["tradingWatchlists"]
---

# Create A Watchlist

`POST /iserver/watchlist`

Create a named watchlist by submitting a set of conids.

## Request body

- object
  - `id` string, required — Must be a number, digits 0-9 only. Must be unique relative to other watchlist IDs.
  - `name` string, required — Arbitrary human-readable name to be displayed in TWS and Client Portal.
  - `rows` IserverWatchlistPostRequestBodyContentApplicationJsonSchemaRowsItems[], required — Array of JSON objects corresponding to watchlist rows, one per instruments.
    - `C` string — Conid as string.

## Response `200`

Watchlist creation successful.

- TradingWatchlistsPostNewWatchlistResponse200
  - `id` string — The submitted watchlist ID.
  - `hash` string — IB's internal hash of the submitted watchlist.
  - `name` string — The submitted human-readable watchlist name.
  - `readOnly` boolean — Indicates whether watchlist is write-restricted. User-created watchlists will always show false.
  - `instruments` unknown[] — Array will always be empty. Contents can be queried via `GET /iserver/watchlist?id=`
    - unknown

## Other responses

- `400` — Missing, empty, non-numeric, or out-of-range parameter. The `error` field is always prefixed with `Bad Request:`.
- `401` — Missing, invalid, or unparseable Authorization token.
- `500` — internal server error, returned when incoming request cannot be processed. It can sometimes include subset of bad requests. For example, wrong accountId passed and it can only be detected later in handling request. Error contains reason of the problem.
- `503` — service is unavailable. For example if request takes more than 10s due to some internal service unavailability, request aborted and this status returned

---

[API](https://skmtc.net/interactivebrokers/apis/api-reference.md) · [All operations](https://skmtc.net/interactivebrokers/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interactivebrokers/api-reference/revisions/67f9f562c2c6/schema)