---
updatedAt: 2026-01-28T13:11:16.000Z
---

Fetch the complete documentation index at: https://developer.connecteam.com/llms.txt. Use this file to discover all available pages before exploring further.

# 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.

```json
{
  "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.

```json
{
  "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](https://developer.connecteam.com/reference/)