> ## Documentation Index
> Fetch the complete documentation index at: https://help.hoopai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Task delete | Webhook events

> Fires whenever a task is permanently removed from a contact in an account.

When a task is deleted from a contact record — whether manually by a team member or through an automation — HoopAI sends a `TaskDelete` event to all configured webhook endpoints. Use this event to remove the corresponding item from external systems, update reporting, or log the deletion for audit trail purposes.

## Payload

| Field        | Type     | Description                                                     |
| ------------ | -------- | --------------------------------------------------------------- |
| `type`       | `string` | Always `"TaskDelete"`                                           |
| `locationId` | `string` | Account ID the task belonged to                                 |
| `id`         | `string` | Unique ID of the deleted task                                   |
| `title`      | `string` | Short display name of the task at the time of deletion          |
| `body`       | `string` | Full description or details of the task at the time of deletion |
| `contactId`  | `string` | ID of the contact this task was associated with                 |
| `assignedTo` | `string` | ID of the user who was responsible for the task                 |
| `dateAdded`  | `string` | ISO 8601 timestamp when the task was originally created         |
| `dueDate`    | `string` | ISO 8601 timestamp by which the task was due                    |

## Example payload

```json theme={null}
{
  "type": "TaskDelete",
  "locationId": "ve9EPM428h8vShlRW1KT",
  "id": "UlRWGLSXh0ji5qbiGu4i",
  "assignedTo": "63e4qiWDsFJjOYAC8phG",
  "body": "Loram ipsum",
  "contactId": "CWBf1PR9LvvBkcYqiXlc",
  "title": "Loram ipsum",
  "dateAdded": "2021-11-26T12:41:02.193Z",
  "dueDate": "2021-11-26T12:41:02.193Z"
}
```

## Related

* [Task create](/api-reference/webhooks/task-create) — fires when a new task is added
* [Contacts API](/api-reference/contacts/overview) — manage contacts and their associated tasks