Tasks webhook

Upon integrating with the Quick Tasks webhook, you will be notified of various events that reflect actions taken by users and admins within the Quick Tasks feature.

These events are crucial for real-time monitoring, automation, and syncing task-related activities with your third-party systems.

🚧

Important to know

This article provides helpful insights and examples about Quick Tasks events. For the most up-to-date information, please follow the Connecteam API Reference.

Events Overview

Below is a detailed overview of the events you can expect to receive (you can configure the relevant events when setting up the webhook through the API or UI):

Additional Information Provided

For both published and completed events, the webhook will send the full payload of the task, containing the task's metadata such as ID, assigned user IDs, status, start time, due date, labels, and type.

👍

Good to know

The task description field is not included at this stage due to technical constraints but is planned for future support.

Event Examples

This section includes examples of the JSON payloads for the supported event types, illustrating how the data is structured and what information is included:

task_published

{
  "requestId": "2f3a33f7-fe92-4e14-802a-f149d6a5c839",
  "company": "ihvttbbaqgxncryn",
  "activityType": "Task",
  "eventTimestamp": 1745751910,
  "evnetTimestamp": 1745751910,
  "eventType": "task_published",
  "data": [
    {
      "id": "680e0f66cdbaf2dd5d47bae7",
      "taskBoardId": 9454803,
      "userIds": [
        9170357
      ],
      "status": "published",
      "title": "test",
      "startTime": 1745751894,
      "dueDate": 1745755494,
      "labelIds": [],
      "type": "oneTime",
      "isArchived": false
    }
  ]
}

task_completed

{
  "requestId": "539e0292-3df3-47c9-a3fe-a186d37bccb0",
  "company": "ihvttbbaqgxncryn",
  "activityType": "Task",
  "eventTimestamp": 1745751984,
  "evnetTimestamp": 1745751984,
  "eventType": "task_completed",
  "data": [
    {
      "id": "680e0f66cdbaf2dd5d47bae7",
      "taskBoardId": 9454803,
      "userIds": [
        9170357
      ],
      "status": "completed",
      "title": "test",
      "startTime": 1745751894,
      "dueDate": 1745755494,
      "labelIds": [],
      "type": "oneTime",
      "isArchived": false
    }
  ]
}

👍

Good to know

Always review the latest payload examples in the API reference to ensure your system processes the most current data structure.