---
title: "Create Workflow Execution"
method: POST
path: "/workflow/workflow-executions"
tags: ["workflow-executions"]
---

# Create Workflow Execution

`POST /workflow/workflow-executions`

## Request

- Base URL: `https://api.anyreach.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.anyreach.ai/workflow/workflow-executions`
- Auth: HTTP bearer

Create a workflow execution

## Headers

- `x-anyreach-org` string, nullable: Organization ID for user PATs (pat_ prefix tokens)

## Request body

- WorkflowExecutionCreateSchema
  - `initial_step` string, nullable, required
  - `input_data` object, required
  - `workflow_id` string, uuid, nullable
  - `workflow_version` integer, nullable
  - `definition` WorkflowInput
  - `trigger_id` string, uuid, nullable
  - `source` 'manual' | 'trigger' | 'credential_refresh'
  - `scheduled_at` string, date-time, nullable
  - `redact_input` string[]: Dotted paths of keys into input_data, e.g. user_context.signature, whose values the run uses but does not keep. The response returns the run's results as they are. In the stored run, the input shows «redacted» at each path, and so does every copy of the whole input; a value copied anywhere else is replaced only if it is a string of six or more characters, and so is an equal value from anywhere else. Logs and error reports lose every redacted value. A path that names nothing is skipped; one that runs into a list, a scalar or null hides that value whole. Synchronous runs only.

## Response `200`

Successful Response

- WorkflowExecutionCreateResponseSchema
  - `status` 'success' | 'failed' | 'in_progress' | 'pending' | 'waiting', required
  - `execution_id` string, required
  - `context` object, required
  - `output` object, required

## Other responses

- `404`: Not found
- `422`: Validation Error

---

[API](https://skmtc.dev/anyreach/apis/anyreach-api.md) - [All operations](https://skmtc.dev/anyreach/apis/anyreach-api/llms.txt) - [OpenAPI document](https://skmtc.dev/anyreach/apis/anyreach-api/revisions/2eddf40c8c93?raw)