> ## 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"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.