---
title: "Create situation watchlist"
method: POST
path: "/v1/situations/watchlists"
tags: ["Special Situations"]
---

# Create situation watchlist

`POST /v1/situations/watchlists`

## Request

- Base URL: `https://api.turos.app`
- URL: `https://api.turos.app/v1/situations/watchlists`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Create a situation-scoped watchlist monitor.

## Request body

- object
  - `name` string, required
  - `query` string, required
  - `searchMode` 'situation', required
  - `filters` object, required
    - `situationIds` string[]
    - `types` string[]
    - `subtypes` string[]
    - `statuses` string[]
    - `tickers` string[]
    - `sectors` string[]
  - `startAt` string, date-time, nullable
  - `delivery` union
    - object
      - `type` 'email', required
      - `config` object, required
        - `to` string, email, required
    - object
      - `type` 'webhook', required
      - `config` object, required
        - `organizationEventFanout` boolean, required

## Response `201`

Situation-scoped watchlist monitor.

- object
  - `object` 'monitor', required
  - `id` string, required
  - `orgId` string, required
  - `name` string, required
  - `query` string, required
  - `filters` object, required
  - `searchMode` 'situation', required
  - `webhookUrl` string, nullable, required
  - `delivery` object, required
    - `type` 'webhook' | 'email', required
    - `config` object, required
    - `status` string, required
  - `isActive` boolean, required
  - `lastCheckedAt` string, date-time, nullable, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `default`: Contract-aware error response

---

[API](https://skmtc.dev/turos/apis/turos-api.md) · [All operations](https://skmtc.dev/turos/apis/turos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/turos/apis/turos-api/revisions/a68d3ec80a56?raw)