# Create a workflow

> Create a workflow and scaffold its starting files. Pull the scaffold with the bundle URL.

Source: https://docs.generalinput.com/api/workflows/create



<Endpoint method="POST" path="/v1/workflows" />

<Access scope="workflows:manage" />

## Body [#body]

| Field          | Type   | Required | Notes                                                                             |
| -------------- | ------ | -------- | --------------------------------------------------------------------------------- |
| `workflowType` | string | yes      | `code`, `agent`, or `app`. Skills are created under [skills](/api/skills/create). |
| `name`         | string | no       | Up to 200 characters, Title Case. A name is generated when omitted.               |

## Response [#response]

The new workflow's detail.

```json
{
  "id": "wf_01HX…",
  "name": "Daily Digest",
  "workflowType": "code",
  "isEnabled": false,
  "isValid": false,
  "storagePath": "workflows/wf_01HX…",
  "updatedAt": "2026-09-03T10:00:00.000Z"
}
```

The scaffold is already stored as the live bundle. Download it with [bundle URL](/api/workflows/bundle-url), edit, then push through [bundle upload URL](/api/workflows/bundle-upload-url).