Monitoring (overvågning)
When a company is transferred to a third-party system using Lasso, it is automatically monitored and sends updates continuously. In some situations your data may come from other sources, and in that case it can make sense to add the companies in your system to monitoring yourself.
This page describes how to add and remove companies from monitoring, and how to see which companies are currently monitored.
Add a company to monitoring
To add a company to monitoring, call the endpoint below. The result is that we now monitor your
company in your external system under the id you provided. Any update to the company will result
in an update being sent to your system.
POST https://api.lassox.com/apps/monitoring/jobs/thirdparty/{Provider}/items
POST https://api.lassox.com/apps/monitoring/jobs/thirdparty/Pipedrive/items?lassoId=CVR-1-34580820&id=4321&sendUpdate=true&accesskey=YOUR_API_KEY
| Parameter | In | Type | Description |
|---|---|---|---|
Provider |
path | string | Our unique name for the external system, e.g. Pipedrive, DynamicsCRM, HeroFlows or HubSpot. |
lassoId |
query | string | The Lasso Id of the company you want to monitor. |
id |
query | string | The id of the company in your external system. |
sendUpdate |
query | boolean | Whether to send an update to your system immediately. See Send an update when adding. |
accesskey |
query | string | Your API key. |
Send an update when adding
If you want an update sent right away, set the sendUpdate parameter to true. Note that the
update runs through our background services, so a little time will pass between calling the endpoint
above and the update coming through.
Remove a company from monitoring
You can likewise remove a company from monitoring using the same third-party endpoint with the
DELETE verb.
DELETE https://api.lassox.com/apps/monitoring/jobs/thirdparty/{Provider}/items
DELETE https://api.lassox.com/apps/monitoring/jobs/thirdparty/Pipedrive/items?lassoId=CVR-1-34580820&id=4321
| Parameter | In | Type | Description |
|---|---|---|---|
Provider |
path | string | Our unique name for the external system, e.g. Pipedrive, DynamicsCRM, HeroFlows or HubSpot. |
lassoId |
query | string | The Lasso Id of the company you want to stop monitoring. |
id |
query | string | The id of the company in your external system. |
See which companies are monitored
To see which companies are already registered for monitoring, you can retrieve the full list using the endpoint below.
GET https://api.lassox.com/apps/monitoring/jobs/{JobId}/items
GET https://api.lassox.com/apps/monitoring/jobs/{JobId}/items?take=1000&continuationToken=null
| Parameter | In | Type | Description |
|---|---|---|---|
JobId |
path | string | The unique id of the monitoring job. See Finding your Job id. |
take |
query | integer | How many results you want per page. |
continuationToken |
query | string | The token for the next page. If there are more pages, the response includes a continuationToken that you pass back in this parameter to retrieve the following page, and so on. |
Finding your Job id
The JobId is the unique id of the monitoring job. You can find it by calling the endpoint below,
which returns a full list of your monitoring jobs.
GET https://api.lassox.com/apps/monitoring/jobs