Task Webhooks

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. 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.

{
  "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.

{
  "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"
  }
}

Start here

Webhooks

Core concepts

Events

Payload examples

`task.created`

`task.completed`

​Events

​Payload examples

​task.created

​task.completed

Events

Payload examples

`task.created`

`task.completed`