Tasks webhook

The Tasks webhook notifies you when Quick Tasks are published or completed.

Events

Event Type	Description
task_published	A task was published and assigned to users
task_completed	A task was marked as completed

📝
Note
Recurring tasks do not trigger the task_published event. The task description field is not currently included in webhook payloads.

Event Examples

task_published

Triggered when a task is published. If multiple tasks are created at once, they are sent in a single webhook as an array.

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

task_completed

Triggered when a task is marked as done.

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

Payload Fields

Field	Type	Description
id	string	Unique task identifier
taskBoardId	integer	ID of the task board
title	string	Task title
userIds	array	Assigned user IDs
status	string	`draft`, `published`, or `completed`
type	string	`oneTime` or `recurring`
startTime	integer	Unix timestamp of start time
dueDate	integer	Unix timestamp of due date
labelIds	array	IDs of assigned labels
isArchived	boolean	Whether the task is archived

API Reference