---
title: "Create Folder"
method: POST
path: "/user/folder"
tags: ["Folders"]
---

# Create Folder

`POST /user/folder`

## Request

- Base URL: `https://app.famulor.de/api`
- URL: `https://app.famulor.de/api/user/folder`
- Auth: HTTP bearer

Create a folder to organize your assistants

[Docs](https://docs.famulor.io/api-v1/folders/create)

## Request body

- object
  - `name` string, required: The folder name (max 255 characters). Must be unique within your account.
  - `color` 'gray' | 'slate' | 'red' | 'orange' | 'amber' | 'green' | 'teal' | 'blue' | 'purple' | 'pink': A color for the folder badge. One of: `gray`, `slate`, `red`, `orange`, `amber`, `green`, `teal`, `blue`, `purple`, `pink`.

## Response `201`

Success Response

- object
  - `message` string: Success message
  - `data` object
    - `id` integer: The unique identifier of the created folder
    - `name` string: The folder name
    - `color` string: The folder color (or `null`)
    - `assistants_count` integer: Number of assistants in this folder (always `0` for a new folder)

## Other responses

- `401`: Fehlender oder ungültiger API-Key.
- `422`: Validation Error

---

[API](https://skmtc.dev/famulor/apis/famulor-api.md) · [All operations](https://skmtc.dev/famulor/apis/famulor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/famulor/apis/famulor-api/revisions/3b938c370721?raw)