---
title: "Add Symbols to Watchlist"
method: POST
path: "/v1/watchlists/{watchlist_id}/symbols"
tags: ["Watchlists"]
---

# Add Symbols to Watchlist

`POST /v1/watchlists/{watchlist_id}/symbols`

## Request

- Base URL: `https://api.tradier.com`
- URL: `https://api.tradier.com/v1/watchlists/{watchlist_id}/symbols`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/tradier/apis/tradier-brokerage-api/docs/v1/watchlists/:watchlist_id/symbols/post.ts> (a function with typed inputs; its response is checked against the schema)

Add symbols to an existing watchlist. If the symbol exists, it will be over-written.

## Path parameters

- `watchlist_id` string, required

## Headers

- `Content-Type` 'application/x-www-form-urlencoded', required
- `Accept` 'application/json', required

## Request body `application/x-www-form-urlencoded`

- object
  - `symbols` string, required: Comma-delimited list of symbols to add to watchlist

## Response `200`

Symbols added successfully

- WatchlistResponse
  - `watchlist` Watchlist
    - `name` string: The watchlist name
    - `id` string: The watchlist ID
    - `public_id` string: The public ID of the watchlist
    - `items` object
      - `item` WatchlistItem[]: List of symbols in the watchlist
        - `symbol` string: The security symbol
        - `id` string: The symbol ID (lowercase)

## Other responses

- `400`: Invalid request parameters or body
- `401`: Authentication required or invalid credentials
- `404`: The requested resource was not found

---

[API](https://skmtc.dev/tradier/apis/tradier-brokerage-api.md) - [All operations](https://skmtc.dev/tradier/apis/tradier-brokerage-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tradier/apis/tradier-brokerage-api/revisions/3cda47abe673?raw)