Event
This event fires when a task reaches its final step and is marked as completed. All documents, signatures, and outputs are finalized at this point.
Payload Example
{
"event": "flows.tasks.completed",
"event_id": "evt_01HXYZ9900112233",
"organization_id": "org_abc123",
"timestamp": "2025-06-07T14:00:00Z",
"data": {
"task_id": "task_def456",
"workflow_id": "wf_contract_review",
"workflow_name": "Contract Review",
"initiated_by": "john.doe@example.com",
"completed_at": "2025-06-07T14:00:00Z",
"duration_hours": 29.5,
"variables": {
"contract_name": "Vendor Agreement Q3",
"counterparty": "Acme Corp"
},
"outputs": {
"signed_document_id": "file_signed_xyz789"
}
}
}
Payload Fields
Envelope
| Field | Type | Description |
|---|
event | string | Always flows.tasks.completed |
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 completed task |
workflow_id | string | ID of the parent workflow |
workflow_name | string | Human-readable workflow name |
initiated_by | string | Email of the user who initiated the task |
completed_at | string | ISO 8601 UTC timestamp of task completion |
duration_hours | number | Total time from task creation to completion, in hours |
variables | object | Input variables provided at task initiation |
outputs | object | Key outputs generated by the task (e.g., signed document IDs) |
Notes
Use this event to trigger post-completion actions in your systems — such as archiving signed documents, updating a CRM record, or notifying stakeholders.
