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

# Create folder

`POST /folders/create`

Create a new folder. Max 50 folders per user.

## Request body

- object
  - `name` string, required — Folder name.
  - `sort_order` integer — Sort position. Lower numbers appear first.

## Response `201`

Created folder.

- object
  - `data` Folder
    - `id` string, uuid
    - `user_id` string
    - `name` string
    - `is_default` boolean
    - `sort_order` integer
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `400` — Limit reached (50 folders).
- `409` — A folder with that name already exists.

---

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