Skip to main content

​
Event

flows.tasks.created
This event fires when a new task is initiated — either via the Initiate Workflow API or through the Chamelio web application. The task is at its first step and awaiting action.

​
Payload Example

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

FieldTypeDescription
eventstringAlways flows.tasks.created
event_idstringUnique delivery ID — use to deduplicate retries
organization_idstringID of the organization
timestampstringISO 8601 UTC timestamp of the event
dataobjectEvent-specific payload (see below)

​
Data Object

FieldTypeDescription
task_idstringUnique identifier of the new task
workflow_idstringID of the workflow this task was initiated from
workflow_namestringHuman-readable workflow name
workflow_versionintegerWorkflow version used for this task
initiated_bystringEmail of the user who initiated the task
current_stepobjectDetails of the first step (see below)
variablesobjectInput variables provided at task initiation

​
Step Object

FieldTypeDescription
step_idstringUnique identifier of the step
step_namestringHuman-readable step name
assigneestringEmail of the user assigned to this step