---
title: "Create Workflow"
method: POST
path: "/workflows"
tags: ["Workflows"]
---

# Create Workflow

`POST /workflows`

Create a new workflow.

## Headers

- `authorization` string

## Request body

- Workflow — High-level definition of a multi-step document processing workflow.
  - `id` string
  - `name` string, required
  - `description` string, nullable
  - `owner_id` string, required — Organization / developer ID owning this workflow
  - `user_id` string, nullable — End-user ID when created in a narrowed scope
  - `app_id` string, nullable — App ID when created inside an application context
  - `steps` ConfiguredAction[], required — Ordered list of actions to execute
    - `action_id` string, required — Registry identifier of the action to execute
    - `parameters` object — JSON-serialisable parameters for the action
  - `system_metadata` object

## Response `200`

Successful Response

- Workflow — High-level definition of a multi-step document processing workflow.
  - `id` string
  - `name` string, required
  - `description` string, nullable
  - `owner_id` string, required — Organization / developer ID owning this workflow
  - `user_id` string, nullable — End-user ID when created in a narrowed scope
  - `app_id` string, nullable — App ID when created inside an application context
  - `steps` ConfiguredAction[], required — Ordered list of actions to execute
    - `action_id` string, required — Registry identifier of the action to execute
    - `parameters` object — JSON-serialisable parameters for the action
  - `system_metadata` object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/morphik-org/apis/fastapi.md) · [All operations](https://skmtc.dev/morphik-org/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/morphik-org/fastapi/revisions/9ae5bfba3a15/schema)