> ## 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 create | Webhook events

> Fires whenever a new task is created on a contact in an account.

Tasks in HoopAI are action items attached to a contact record. When a new task is created — whether manually by a team member or triggered by an automation — HoopAI sends a `TaskCreate` event to all configured webhook endpoints. Use this event to mirror tasks in external project management tools, assign follow-ups in a help desk, or trigger reminder workflows.

## Payload

| Field        | Type     | Description                                              |
| ------------ | -------- | -------------------------------------------------------- |
| `type`       | `string` | Always `"TaskCreate"`                                    |
| `locationId` | `string` | Account ID the task belongs to                           |
| `id`         | `string` | Unique ID of the newly created task                      |
| `title`      | `string` | Short display name of the task                           |
| `body`       | `string` | Full description or details of the task                  |
| `contactId`  | `string` | ID of the contact this task is associated with           |
| `assignedTo` | `string` | ID of the user responsible for completing the task       |
| `dateAdded`  | `string` | ISO 8601 timestamp when the task was created             |
| `dueDate`    | `string` | ISO 8601 timestamp by which the task should be completed |

## Example payload

```json theme={null}
{
  "type": "TaskCreate",
  "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 complete](/api-reference/webhooks/task-complete) — fires when a task is marked as done
* [Task delete](/api-reference/webhooks/task-delete) — fires when a task is removed
* [Contacts API](/api-reference/contacts/overview) — manage contacts and their associated tasks