# Subscribing to project events with webhooks

**Category:** [Project Manager](https://help.totalctrl.app/hc/totalctrl/totalctrl-help-center/en-US/categories/project-manager)
**Updated:** 2026-08-19

## Events you can subscribe to

In **Settings → Webhooks**, under the Projects group:

- `task.created`, `task.updated`, `task.deleted`
- `task.status_changed`, `task.completed`, `task.reopened`
- `task.assignee_changed`, `task.priority_changed`, `task.due_date_changed`
- `task.custom_field_changed`, `task.group_changed`, `task.parent_changed`
- `task.label_added`, `task.label_removed`
- `task.due_soon`, `task.due_today`, `task.overdue`

## Which one to use

`task.updated` fires for every change and carries a `changes` list of `{field, from, to}`. The per-field events exist so you do not have to receive every save and work out what moved — subscribe to `task.status_changed` and you get only status moves, with `from` and `to` already in the payload.
## The payload

Every task event carries the same shape: `project_id`, `project_uid`, `project_title`, `task_id`, `task_title`, `status`, `priority`, `assignee_id`, `assignee_name`, `due_date`, `group`, `parent_id` and `is_complete`. Change events add `from` and `to`; the custom-field event adds `field_title`, `field_id` and `field_type`; the label events add `label`.
## Reading the rules over the API

`GET /api/v1/projects/{project_id}/automations` lists the rules on a project, each with the sentence it reads as, whether it is active, and when it last ran. It is read-only: a rule can move somebody else's work, and the sentence is what makes it reviewable.

---

## Related Articles

- [Project Manager overview](https://help.totalctrl.app/en-US/articles/project-manager-overview)
- [Working with Tasks](https://help.totalctrl.app/en-US/articles/working-with-tasks)
- [Conditions: reacting to one value](https://help.totalctrl.app/en-US/articles/project-automation-conditions)
- [Every trigger, and what it carries](https://help.totalctrl.app/en-US/articles/project-automation-triggers)
- [Getting started with project automations](https://help.totalctrl.app/en-US/articles/project-automations-getting-started)

---
[← Back to TotalCtrl Help Center](https://help.totalctrl.app/en-US/)