---
title: "Create Company Watchlist"
method: POST
path: "/watchlists/companies"
tags: ["companies"]
---

# Create Company Watchlist

`POST /watchlists/companies`

## Request body

- CompanyWatchlistInput
  - `name` string, required
  - `shared_with_team` boolean, required
  - `user_watchlist_type` 'USER_MANAGED_WATCHLIST' | 'CUSTOMER_MANAGED_WATCHLIST' | 'USER_FAVORITED_ENTITIES' | 'USER_HIDDEN_ENTITIES' | 'CUSTOMER_PORTFOLIO_LIST' | 'CUSTOMER_AFFINITY_SYNCED_LIST' | 'GLOBAL_FIELD_LIST'
  - `companies` string[]

## Response `200`

Successful Response

- ResourceUrnResponseUnionCompanyWatchlistUrnSynapseListUrn
  - `urn` union, required
    - string
    - string
  - `metadata` DBOperationMetadata
    - `count_total` integer, nullable
    - `count_changed` integer, nullable
    - `count_skipped` integer, nullable
    - `count_not_found` integer, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/harmonic/apis/harmonic-ai-public-api.md) · [All operations](https://skmtc.net/harmonic/apis/harmonic-ai-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/harmonic/harmonic-ai-public-api/revisions/fbef1ba78f96/schema)