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

# flows.tasks.created

> Fired when a new workflow task is created in Chamelio Flows and the first step is ready for action, allowing systems to notify assignees or start tracking work.

## Event

```
flows.tasks.created
```

This event fires when a task is initiated - either through the [Initiate Workflow](https://docs.chamelio.ai/api-reference/endpoint/workflows/initiate.md) API or from the Chamelio web application. The task sits at its first step, awaiting action.

## Payload Example

```json theme={null}
{
  "event": "flows.tasks.created",
  "event_id": "3f7c1a8e-5b2d-4e9a-9c31-8a6f0d4b7e12",
  "organization_id": 42,
  "user_id": 1337,
  "payload_version": 1,
  "timestamp": "2026-09-02T14:32:00Z",
  "data": {
    "workflow_id": "wf_contract_review",
    "workflow_state_id": "ws_9f2a41c8",
    "workflow_version": 3,
    "task_id": 12345,
    "requester_id": 1337,
    "owner_id": 2048,
    "intake_channels": [
      "web"
    ]
  }
}
```

## Payload Fields

### Envelope

| Field | Type | Description |
| - | - | - |
| `event` | string | Always `flows.tasks.created` |
| `event_id` | string | UUID for this delivery. Use it to deduplicate retries |
| `organization_id` | integer | ID of the organization the event occurred in |
| `user_id` | integer or null | ID of the user who initiated the task |
| `payload_version` | integer | Envelope schema version. Currently `1` |
| `timestamp` | string | ISO 8601 UTC timestamp of when the event was generated |
| `data` | object | Event-specific payload (see below) |

### Data Object

| Field | Type | Description |
| - | - | - |
| `workflow_id` | string | ID of the workflow this task was initiated from |
| `workflow_state_id` | string | ID of this particular workflow run |
| `workflow_version` | integer | Version of the workflow used for this task |
| `task_id` | integer | ID of the new task |
| `requester_id` | integer or null | ID of the user who initiated the task |
| `owner_id` | integer or null | ID of the user the task was initially assigned to |
| `intake_channels` | array of strings | Channel the task was intaken through |

> [!NOTE]
>
> This event is only emitted for workflow runs that have a task. A workflow state
> without a `task_id` produces no webhook.

> [!NOTE]
>
> `intake_channels` is derived from the run's first step when that step is an intake step, so it
> contains at most one channel. It is an empty array for workflows that do not begin with an intake
> step.
