> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finscreener.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Watchlist

> Create a new watchlist

Create a new watchlist to track companies, directors, or GST registrations.

## Headers

<ParamField header="Authorization" type="string" required>
  Bearer token: `Bearer <access_token>`
</ParamField>

## Request Body

<ParamField body="name" type="string" required>
  Watchlist name
</ParamField>

<ParamField body="watchlist_type" type="string" required>
  Entity type: `company`, `director`, or `gst`
</ParamField>

<ParamField body="entities" type="array">
  Initial entities to add

  <Expandable title="entity properties">
    <ParamField body="identifier" type="string" required>
      Entity identifier (CIN, DIN, or GSTIN)
    </ParamField>

    <ParamField body="name" type="string" required>
      Entity name
    </ParamField>
  </Expandable>
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.finscreener.in/api/watchlist" \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "Target Companies",
      "watchlist_type": "company",
      "entities": [
        {"identifier": "U72200MH2004PTC148441", "name": "TCS Limited"},
        {"identifier": "L17110MH1973PLC019786", "name": "Reliance Industries"}
      ]
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "data": {
      "id": "wl_789",
      "name": "Target Companies",
      "type": "company",
      "count": 2,
      "created_at": "2026-02-04T12:00:00Z"
    }
  }
  ```
</ResponseExample>