Task status changed 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 Read tasks of a specific employee endpoint with toDoAssigneeId (or the relevant employee ID from the payload) to get full, untruncated task details. For request and response examples, see API call for Task events.

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

Payload
number
required

The company ID

string
enum
required

The event type for task status change

Allowed:
string
required

The backend-id of the employee that triggered the event or 'system' for events triggered automatically by the system

date-time
required

The timestamp when the event occurred

string
required

The webhook version

data
object
required

Contains the actual data and differs for each event type

Headers
string
required

Base64-encoded signature sent with each webhook request. Use it to verify that the request came from Bob. To verify webhook authenticity, see How does Bob calculate the signature.

Responses
200

Webhook received successfully

LoadingLoading…