Skip to content
POST /v1/workflows/{id}/runs

Start a workflow run

Triggers a workflow and returns a run identifier you can poll or subscribe to.

Triggers a workflow and returns a run identifier you can poll or subscribe to.

Headers
Authorization Bearer nx_live_…
Content-Type application/json
Request body
{
  "payload": { "lead_id": "ld_4413" },
  "dry_run": false
}
Response
{
  "run_id": "wr_71ba",
  "status": "running",
  "nodes_total": 5,
  "nodes_complete": 0,
  "started_at": "2026-08-20T09:14:22Z"
}