Real-time monitoring is currently only available for Enterprise customers. To upgrade, get in touch with our sales team.

With our WebSocket API, you can listen to real-time changes from your monitoring workflows.

​
Prerequisites

We strongly recommend using our SDK for real-time updates. The SDK handles the connection, authentication, message acknowledgement, message replay and auto-reconnect. If you need to implement a native WebSocket integration, please contact us.

​
Message Format

All messages are JSON objects with the following fields:

Always present:

  • type: The type of the message.
  • timestamp: The timestamp of the message.

Optional depending on the type:

  • data: The data of the message.
  • id: The ID of the message used for acknowledgement.

​
Message Types

​
workflow_data_change

This message is sent when a workflow data changes.

Fields:

​
id
string

The change ID of the workflow. You can also retrieve the change with screenshot over the /changes endpoint or view the change in the Kadoa dashboard like: https://www.kadoa.com/data-diff/ID

​
workflowId
string

The ID of the workflow. Accessible over the /workflows endpoint or the Kadoa dashboard like: https://www.kadoa.com/workflow/WORKFLOW_ID

​
data
object

The data of the workflow. Full snapshot of the data at the time of the change.

​
diff
object

The diff of the data. For an explanation of the diff format, please refer to the data diff documentation.

​
url
string

The URL of the page the workflow is monitoring.

​
createdAt
string

The timestamp in ISO format when the change was detected.

Example:

{
  "type": "workflow_data_change",
  "timestamp": 1736367604663,
  "id": "2df91fbd-74c1-4d11-91aa-50030393574b",
  "data": {
    "id": "66d0c9e65baad1694a2132d0",
    "workflowId": "677fc12545e790b20a4eec34",
    "data": [
      {"title": "Test News"},
      {"title": "New News"}
    ]
    "diff": {
      "count": 1,
      "added": true,
      "removed": null,
      "value": "\"title\": \"New News\""
    },
    "url": "https://thisismymonitoredpage.com",
    "createdAt": "2025-01-09T10:00:00Z",
  },
}

​
heartbeat

Reconnection logic is handled by the SDK. If you implement a native WebSocket integration, you might need to handle reconnections yourself.

This message is sent every 15 seconds. It’s used to keep the connection alive. If you don’t receive a heartbeat after 30 seconds, the connection is considered lost, reconnection is needed.

Example:

{
  "type": "heartbeat",
  "timestamp": 1736367604663
}
API GuideZapier