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

# Task Webhooks

> Payloads for task created and completed events.

Task webhooks fire when a task is linked to a record or marked as completed.

All task webhooks use the same webhook envelope documented in [Webhooks](/api/webhooks). The `data` object changes by event type.

## Events

| Event            | Category | When it fires                             |
| ---------------- | -------- | ----------------------------------------- |
| `task.created`   | Tasks    | Fired when a task is linked to a record.  |
| `task.completed` | Tasks    | Fired when a task is marked as completed. |

## Payload examples

### `task.created`

Fired when a task is linked to a record.

```json theme={null}
{
  "eventId": "evt_abc123",
  "timestamp": "2026-03-19T12:00:00.000Z",
  "workspaceId": "workspace_id",
  "event": "task.created",
  "data": {
    "recordId": "record_id",
    "taskId": "task_id",
    "title": "Send proposal",
    "status": "todo",
    "dueAt": "2026-03-20T09:00:00.000Z"
  }
}
```

### `task.completed`

Fired when a task is marked as completed.

```json theme={null}
{
  "eventId": "evt_abc123",
  "timestamp": "2026-03-19T12:00:00.000Z",
  "workspaceId": "workspace_id",
  "event": "task.completed",
  "data": {
    "recordId": "record_id",
    "taskId": "task_id",
    "title": "Send proposal",
    "status": "done",
    "dueAt": "2026-03-20T09:00:00.000Z"
  }
}
```