Webhooks
Use webhooks and notifications to automatically get updated data
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.
The response will include the created trigger.
A dummy notification will be sent to the destination URL with the following format.
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).
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.
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 |