---
title: "Create folder"
method: POST
path: "/v1/folders"
tags: ["Folders"]
---

# Create folder

`POST /v1/folders`

Create a new folder to organize workflows

## Headers

- `x-api-key` string, nullable — Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.

## Request body

- FolderCreate — Request model for creating a folder
  - `title` string, required — Folder title
  - `description` string, nullable — Folder description

## Response `200`

Successfully created folder

- Folder — Response model for a folder
  - `title` string, required — Folder title
  - `description` string, nullable — Folder description
  - `folder_id` string, required
  - `organization_id` string, required
  - `workflow_count` integer — Number of workflows in this folder
  - `created_at` string, date-time, required
  - `modified_at` string, date-time, required

## Other responses

- `400` — Invalid request
- `422` — Validation Error

---

[API](https://skmtc.net/skyvern-ai/apis/skyvern-api-2.md) · [All operations](https://skmtc.net/skyvern-ai/apis/skyvern-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skyvern-ai/skyvern-api-2/versions/29562c6e0364/schema)