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

# Create a watchlist

> Creates a new empty watchlist for the caller's team. Returns 201 with the created list and a URL pointing to it.



## OpenAPI

````yaml post /watchlists
openapi: 3.0.4
info:
  title: TIC API
  description: ''
  version: v1
servers:
  - url: https://api.tic.io/
security:
  - ApiKey: []
tags:
  - name: BolagsverketStatistics
  - name: Companies
  - name: Companies_SE_
  - name: DocumentDelivery
  - name: EuropeanCommission
  - name: FinancialDocuments
  - name: Finansinspektionen
  - name: Free
  - name: ICA
  - name: ICAStatistics
  - name: Lists
  - name: Media
  - name: Persons
  - name: Persons_SE_
  - name: Properties_SE_
  - name: PTSPortings
  - name: Reseller
  - name: SearchBankruptciesReports
  - name: SearchCompanies
  - name: SearchCompaniesReports
  - name: SearchCompanyWorkplaces
  - name: SearchPerson
  - name: SearchProperties_SE_
  - name: SearchVehicles
  - name: TeamDocumentOrders
  - name: Teams
  - name: User
  - name: Vehicles_SE_
  - name: WatchLists
paths:
  /watchlists:
    post:
      tags:
        - WatchLists
      summary: Create
      description: Creates a new watchlist
      operationId: WatchListCreate
      requestBody:
        description: The payload
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/Ormeo_WebAPI_Models_WatchLists_WatchListCreate_Dto
        required: true
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Ormeo_WebAPI_Models_WatchLists_WatchListDetail_Dto
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '422':
          description: Unprocessable Content
components:
  schemas:
    Ormeo_WebAPI_Models_WatchLists_WatchListCreate_Dto:
      required:
        - watchListName
      type: object
      properties:
        watchListName:
          maxLength: 255
          minLength: 1
          type: string
        watchListDescription:
          maxLength: 255
          type: string
          nullable: true
      additionalProperties: false
    Ormeo_WebAPI_Models_WatchLists_WatchListDetail_Dto:
      type: object
      properties:
        teamWatchListId:
          type: integer
          format: int32
        watchListName:
          type: string
          nullable: true
        watchListDescription:
          type: string
          nullable: true
        numberOfMembersOnWatchList:
          type: integer
          format: int32
        lastUpdatedAtUtc:
          type: string
          format: date-time
          nullable: true
      additionalProperties: false
  securitySchemes:
    ApiKey:
      type: apiKey
      name: x-api-key
      in: header

````