> ## 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.

# Add trigger to watchlist

> Add a trigger to the watchlist

On 2025-05-02 we made a change so creating triggers will monitor all
available events and push them invidually. Earlier we required
you to instruct which events you wanted to watch.

This means that the webhook will contain a payload containing an
array of events.

Example of how the payload will look like:

```json Webhook post to your endpoint theme={null}
[
  {
    "teamWatchListMemberEventId": 1,
    "teamWatchListMemberId": 9029,
    "teamWatchListId": 18,
    "externalId": "MY_NUMBER_1",
    "companyId": 12345678,
    "watchListMemberEventType": "companyAddress",
    "eventDate": "2024-02-02T10:49:24",
    "lastUpdatedAtUtc": "2025-05-02T11:30:09"
  },
  {
    "teamWatchListMemberEventId": 2,
    "teamWatchListMemberId": 9029,
    "teamWatchListId": 18,
    "externalId": "MY_NUMBER_2",
    "companyId": 12345678,
    "watchListMemberEventType": "companyRegistration",
    "eventDate": "2025-04-09T15:21:04",
    "lastUpdatedAtUtc": "2025-05-02T11:30:09"
  },
  {
    "teamWatchListMemberEventId": 3,
    "teamWatchListMemberId": 9029,
    "teamWatchListId": 18,
    "externalId": "MY_NUMBER_3",
    "companyId": 12345678,
    "watchListMemberEventType": "companyIntelligence",
    "eventDate": "2025-04-13T15:47:27",
    "lastUpdatedAtUtc": "2025-05-02T11:30:09"
  },
  {
    "teamWatchListMemberEventId": 4,
    "teamWatchListMemberId": 9029,
    "teamWatchListId": 18,
    "externalId": "MY_NUMBER_4",
    "companyId": 12345678,
    "watchListMemberEventType": "companyFinancialDocument",
    "eventDate": "2025-02-25T08:51:23",
    "lastUpdatedAtUtc": "2025-05-02T11:30:09"
  }
]
```

## WatchListMemberEventTypes

The property watchListMemberEventType has the following valid types.

| Type                     | Description                                                                      |
| ------------------------ | -------------------------------------------------------------------------------- |
| companyAddress           | New information surrounding one or multiple addresses                            |
| companyName              | New information surrounding names of the business                                |
| companyStatus            | New information surrounding status of the business                               |
| companyRegistration      | New information surrounding registration of the business (VAT, payroll, tax etc) |
| companyIntelligence      | New information surrounding intelligence of the business                         |
| companyBeneficialOwner   | New information surrounding beneficial owners of the business                    |
| companyWorkplace         | New information surrounding one or multiple workplaces owned by the business     |
| companyPerson            | New information surrounding company representatives                              |
| companyRegisteredOffice  | New information surrounding the companys registered office                       |
| companyShareCapital      | New information surrounding the companys share capital                           |
| companyPurpose           | New information surrounding the company purpose                                  |
| companyDebtBalance       | New information surrounding changes of the debt balance                          |
| companyOrderToPayCase    | New information surrounding one or multiple order to pay cases                   |
| companyFinancialDocument | New information surrounding financial documents such as annual reports           |
| companyCase              | New information surrounding cases (inneliggande ärenden)                         |
| personAddress            | New information surrounding person addresses                                     |
| personName               | New information surrounding person name                                          |
| personStatus             | New information surrounding person status                                        |
| personCompany            | New information surrounding the persons involvement as company representative    |


## OpenAPI

````yaml post /watchlists/{watchListId}/triggers
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/{watchListId}/triggers:
    post:
      tags:
        - WatchLists
      summary: Add trigger to watchlist
      description: Add a trigger to the watchlist
      operationId: AddTriggerToWatchList
      parameters:
        - name: watchListId
          in: path
          description: The watchlist id
          required: true
          schema:
            type: integer
            format: int32
      requestBody:
        description: The payload
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/Ormeo_WebAPI_Models_WatchLists_WatchListTriggerCreate_Dto
        required: true
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Ormeo_WebAPI_Models_WatchLists_WatchListTriggerDetail_Dto
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '422':
          description: Unprocessable Content
components:
  schemas:
    Ormeo_WebAPI_Models_WatchLists_WatchListTriggerCreate_Dto:
      required:
        - destination
      type: object
      properties:
        destination:
          minLength: 1
          type: string
        destinationType:
          $ref: '#/components/schemas/Ormeo_Library_Entities_DestinationType'
      additionalProperties: false
    Ormeo_WebAPI_Models_WatchLists_WatchListTriggerDetail_Dto:
      type: object
      properties:
        teamWatchListTriggerId:
          type: integer
          format: int32
        destination:
          type: string
          nullable: true
        destinationType:
          $ref: '#/components/schemas/Ormeo_Library_Entities_DestinationType'
        hasBeenValidated:
          type: boolean
        lastMessageSentAtUtc:
          type: string
          format: date-time
          nullable: true
        lastUpdatedAtUtc:
          type: string
          format: date-time
          nullable: true
      additionalProperties: false
    Ormeo_Library_Entities_DestinationType:
      enum:
        - webhook
        - email
        - sms
      type: string
  securitySchemes:
    ApiKey:
      type: apiKey
      name: x-api-key
      in: header

````