---
title: "Task status changed webhook"
method: POST
path: "taskChangedStatus"
tags: ["Tasks Webhooks"]
---

# Task status changed webhook

`POST taskChangedStatus` (webhook)

Sent when the status of a general task changes (e.g. completed or incomplete). The payload includes
`toDoIds`, `toDoRequestedForIds`, `toDoAssigneeIds`, and `newStatus`. Long fields (e.g. description or title)
may be truncated in the payload.

**Best practice:** Treat the event as a notification. Call the
<a href="https://apidocs.hibob.com/reference/get_tasks-people-id" target="_blank">Read tasks of a specific employee</a> endpoint
with `toDoAssigneeId` (or the relevant employee ID from the payload) to get full, untruncated task details. For
request and response examples, see <a href="https://apidocs.hibob.com/reference/api-calls-for-webhook-events#task-events" target="_blank">API call for Task events</a>.

In the right panel, open **Examples** and select **Payload Example** to see a real payload.

## Headers

- `bob-signature` string, required

## Payload

- TaskChangedStatusEvent: Event sent when any change occurs in the status of a general task (completed/incomplete). The webhook event payload may contain truncated values (such as the task description or title) in case they are long.
  - `companyId` number, required: The company ID
  - `type` 'todo.changedStatus', required: The event type for task status change
  - `triggeredBy` string, required: The backend-id of the employee that triggered the event or 'system' for events triggered automatically by the system
  - `triggeredAt` string, date-time, required: The timestamp when the event occurred
  - `version` string, required: The webhook version
  - `data` object, required: Contains the actual data and differs for each event type
    - `toDoIds` object[], required: Array of task IDs that changed status
      - `id` number, required: The task ID
    - `toDoRequestedForIds` string[], required: Array of employee IDs for whom the tasks were requested
    - `toDoAssigneeIds` string[], required: Array of employee IDs assigned to the tasks
    - `newStatus` string, required: The new status of the task (e.g., Closed, Open)

## Acknowledgement `200`

Webhook received successfully

## Other responses

- `400`: Invalid webhook payload

---

[API](https://skmtc.dev/hibob/apis/tasks-api.md) - [All operations](https://skmtc.dev/hibob/apis/tasks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hibob/apis/tasks-api/revisions/6bffb08e8e09?raw)