---
title: "Start a workflow by name for an end user"
method: POST
path: "/api/workflow/start_by_name"
tags: ["Workflows"]
---

# Start a workflow by name for an end user

`POST /api/workflow/start_by_name`

Start a workflow by name for an end user

## Request body

- WorkflowStartByNameRequestSchema
  - `end_user_heron_id` string, required
  - `trigger_id` string, nullable — Trigger node ID on the resolved workflow version.
  - `trigger_payload` object — JSON payload validated against the trigger node schema when present.
  - `workflow_name` string, required
  - `workflow_parameters` object

## Response `200`

Workflow started successfully

- WorkflowStartResponseSchema
  - `action` string
  - `status` string
  - `workflow_execution_id` string
  - `workflow_id` string

## Other responses

- `400` — Trigger ID or payload is invalid
- `404` — End user or workflow not found

---

[API](https://skmtc.dev/herondata/apis/heron-data-api.md) · [All operations](https://skmtc.dev/herondata/apis/heron-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/herondata/heron-data-api/revisions/f2e441edece2/schema)