You can also setup notification to be triggered to e-mail or by text message (sms) but please note that the e-mail or text message will only contain a narrow summary of what has changed in a watchlist and not all the details. When you receive webhooks you will receive richer data that includes details about the changes.

We provide an API that can be used to create various webhooks. The same api is used to create notifications that be sent by e-mail or a text message to a mobile phone number. Each watchlist could contain multiple webhooks, called triggers, that contains the destination (URL, e-mail address or mobile phone number) and what changes should be notified.

Important information

Before the trigger is enabled is has to be confirmed and the following list described the three different destinations you can choose among.

Trigger with webhook (URL)

Will auto-confirm when the receiving URL returns a succesful status code. Will retry three times.

Trigger with e-mail address

An e-mail will be automatically sent to the address requiring the user to approve to receive notifications for the watchlist by clicking on the link in the e-mail.

Trigger with mobile phone number

A text message will be automatically sent to the mobile phone number to approve to receive notifications for the watchlist by clicking on the link in the text message.

Example creating a trigger with a webhook

The following example shows how you create a simple webhook for a watchlist you have created. The example will react on changes on address, annualreports, intelligence, representatives and status.

cURL
curl  \
--request POST
--header "Content-Type: application/json"
--header "x-api-key:your_api_key"
--data '
    {
        "Destination": "https://webhook.site/cf728358-1738-4ffe-be04-f14a9d28a4de",
        "DestinationType": "webhook",
        "Address": true,
        "AnnualReport": true,
        "Intelligence": true,
        "Representatives": true,
        "Status": true
    }
'
https://api.tic.io/watchlists/6/triggers

The response will include the created trigger.

Response from creating a trigger with a webhook
{
  "teamWatchListTriggerId": 2,
  "destination": "https://webhook.site/cf728358-1738-4ffe-be04-f14a9d28a4de",
  "destinationType": "webhook",
  "address": true,
  "annualReport": true,
  "intelligence": true,
  "representatives": true,
  "status": true,
  "hasBeenValidated": false,
  "lastMessageSentAtUtc": null,
  "lastUpdatedAtUtc": "2024-12-22T10:29:39.1746639Z"
}

A dummy notification will be sent to the destination URL with the following format.

Webhook post
[
  {
    "teamWatchListMemberEventId": 1,
    "teamWatchListMemberId": 1,
    "teamWatchListId": 1,
    "externalId": "EXTERNAL ID 1",
    "companyId": 3503318,
    "watchListMemberEventType": "companyAddress",
    "eventDate": "2024-02-02T10:49:24",
    "lastUpdatedAtUtc": "2025-05-02T11:30:09"
  }
]

Test triggers

You can test triggers that are configured as webhooks. This allows you to test your webhook flow.

Make an http post to the endpoint https://api.tic.io/watchlists/6/test (replace 6 with your trigger id).

cURL
curl  \
--request POST
--header "Content-Type: application/json"
--header "x-api-key:your_api_key"
https://api.tic.io/watchlists/6/triggers/test

We will post a webhook with the data below which contains an array of events. Please note we on 2025-05-02 made a change to include all events are sent where each object includes the source of the change.

Webhook post to your endpoint
[
  {
    "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.

TypeDescription
companyAddressNew information surrounding one or multiple addresses
companyNameNew information surrounding names of the business
companyStatusNew information surrounding status of the business
companyRegistrationNew information surrounding registration of the business (VAT, payroll, tax etc)
companyIntelligenceNew information surrounding intelligence of the business
companyBeneficialOwnerNew information surrounding beneficial owners of the business
companyWorkplaceNew information surrounding one or multiple workplaces owned by the business
companyPersonNew information surrounding company representatives
companyRegisteredOfficeNew information surrounding the companys registered office
companyShareCapitalNew information surrounding the companys share capital
companyPurposeNew information surrounding the company purpose
companyDebtBalanceNew information surrounding changes of the debt balance
companyOrderToPayCaseNew information surrounding one or multiple order to pay cases
companyFinancialDocumentNew information surrounding financial documents such as annual reports
companyCaseNew information surrounding cases (inneliggande ärenden)
personAddressNew information surrounding person addresses
personNameNew information surrounding person name
personStatusNew information surrounding person status
personCompanyNew information surrounding the persons involvement as company representative