---
title: "Create Folder"
method: POST
path: "/v3.0/folders/"
tags: ["folders"]
---

# Create Folder

`POST /v3.0/folders/`

## Request

- Base URL: `https://api.formaloo.me`
- URL: `https://api.formaloo.me/v3.0/folders/`
- Auth: none declared. Required headers: `x-api-key`

## Headers

- `x-api-key` string, required
- `x-workspace` string

## Request body

- FolderRequest
  - `parent_folder` string, nullable: If the folder has a parent folder, send its slug on this field.
  - `icon_slug` string, nullable
  - `title` string, required: title of the folder.
  - `color` string, nullable: folder color settings or color code.

## Response `201`

- Folder
  - `subfolders_count` string
  - `slug` string, nullable
  - `parent_folder` string, nullable: If the folder has a parent folder, send its slug on this field.
  - `subfolders` string
  - `shared_access` string
  - `icon_url` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `title` string, required: title of the folder.
  - `color` string, nullable: folder color settings or color code.

---

[API](https://skmtc.dev/formaloo/apis/formaloo-api-documentation.md) · [All operations](https://skmtc.dev/formaloo/apis/formaloo-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/formaloo/apis/formaloo-api-documentation/revisions/47b268aeb656?raw)