> ## 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 and its first step is ready for action.

## Event

```
flows.tasks.created
```

This event fires when a new task is initiated — either via the [Initiate Workflow](/api-reference/endpoint/workflows/initiate) API or through the Chamelio web application. The task is at its first step and awaiting action.

## Payload Example

```json theme={null}
{
  "event": "flows.tasks.created",
  "event_id": "evt_01HXYZ7788990011",
  "organization_id": "org_abc123",
  "timestamp": "2025-06-06T08:00:00Z",
  "data": {
    "task_id": "task_def456",
    "workflow_id": "wf_contract_review",
    "workflow_name": "Contract Review",
    "workflow_version": 3,
    "initiated_by": "john.doe@example.com",
    "current_step": {
      "step_id": "step_1",
      "step_name": "Initial Review",
      "assignee": "reviewer@example.com"
    },
    "variables": {
      "contract_name": "Vendor Agreement Q3",
      "counterparty": "Acme Corp"
    }
  }
}
```

## Payload Fields

### Envelope

| Field             | Type   | Description                                     |
| ----------------- | ------ | ----------------------------------------------- |
| `event`           | string | Always `flows.tasks.created`                    |
| `event_id`        | string | Unique delivery ID — use to deduplicate retries |
| `organization_id` | string | ID of the organization                          |
| `timestamp`       | string | ISO 8601 UTC timestamp of the event             |
| `data`            | object | Event-specific payload (see below)              |

### Data Object

| Field              | Type    | Description                                     |
| ------------------ | ------- | ----------------------------------------------- |
| `task_id`          | string  | Unique identifier of the new task               |
| `workflow_id`      | string  | ID of the workflow this task was initiated from |
| `workflow_name`    | string  | Human-readable workflow name                    |
| `workflow_version` | integer | Workflow version used for this task             |
| `initiated_by`     | string  | Email of the user who initiated the task        |
| `current_step`     | object  | Details of the first step (see below)           |
| `variables`        | object  | Input variables provided at task initiation     |

### Step Object

| Field       | Type   | Description                             |
| ----------- | ------ | --------------------------------------- |
| `step_id`   | string | Unique identifier of the step           |
| `step_name` | string | Human-readable step name                |
| `assignee`  | string | Email of the user assigned to this step |