---
title: "Task triggered webhook"
method: POST
path: "taskAssign"
tags: ["Tasks Webhooks"]
---

# Task triggered webhook

`POST taskAssign` (webhook)

Sent when a task list is triggered and one or more general tasks are created. The payload includes
`requestedForEmployeeId` (the employee the tasks are for), `workflowId`, `pivotDate`, and `toDoIds` (task IDs).

**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 `requestedForEmployeeId` to retrieve full 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

- TaskAssignEvent: Event sent when a task list is triggered. Each general task that is created will trigger this event.
  - `companyId` number, required: The company ID
  - `type` 'todo.assign', required: The event type for task assignment
  - `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
    - `requestedForEmployeeId` string, required: The employee ID for whom the task was requested
    - `workflowId` number, required: The workflow ID that triggered the task list
    - `pivotDate` string, date, required: The anchor date that determines when workflow tasks are scheduled and when they are due.
    - `toDoIds` object[], required: Array of task IDs that were created
      - `id` number, required: The task ID

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