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

# Create a folder

`POST /folders`

## Request body

- object
  - `name` string, required
  - `parent_id` string, nullable — Parent folder id to nest under, or omit for a top-level folder

## Response `201`

Folder created

- object
  - `data` Folder
    - `id` string
    - `name` string
    - `parent_id` string, nullable — Parent folder id, or null for a top-level folder
    - `item_count` integer — Number of media items directly in this folder
    - `created_at` string, date-time

## Other responses

- `400` — Invalid name or parent

---

[API](https://skmtc.dev/omnisocials/apis/omnisocials-api.md) · [All operations](https://skmtc.dev/omnisocials/apis/omnisocials-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/omnisocials/omnisocials-api/revisions/e53b89af0b98/schema)