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

# Create a new folder

`POST /folder`

## Request

- Base URL: `https://public.stonly.com/api/v3`
- URL: `https://public.stonly.com/api/v3/folder`
- Auth: HTTP basic

Creates a new directory for organizing content. Returns the `folderId` of the new folder.

## Query parameters

- `teamId` integer

## Request body

- Folder
  - `parentFolderId` number: ID of the parent folder. Omit to create at the root level.
  - `name` string: Name of the new folder.
  - `description` string: Optional description.
  - `publicAccess` 0 | 1: 1 = Public, 0 = Private/Restricted.
  - `language` 'am' | 'ar' | 'bg' | 'bn' | 'bs' | 'ca' | 'cn' | 'cs' | 'cy' | 'da' | 'de' | 'de-AT' | 'de-CH' | 'el' | 'en' | 'en-GB' | 'en-US' | 'es' | 'es-CL' | 'es-EC' | 'et' | 'eu' | 'fa' | 'fi' | 'fr' | 'fr-BE' | 'fr-CA' | 'ga' | 'gd' | 'he' | 'hi' | 'hr' | 'hu' | 'hy' | 'id' | 'is' | 'it' | 'ja' | 'ka' | 'kn' | 'ko' | 'lt' | 'lv' | 'mi' | 'mk' | 'nb' | 'nl' | 'nl-BE' | 'nn' | 'no' | 'pl' | 'pt' | 'pt-BR' | 'ro' | 'ru' | 'sk' | 'sl' | 'sq' | 'sr' | 'sv' | 'sw' | 'th' | 'tl' | 'tr' | 'uk' | 'ur' | 'vi' | 'zh' | 'zh-Hant': The ISO 639-1 language code (with some regional variants). Supported values map as follows: |---|---|---|---|---|---| | `am` | Amharic | `ar` | Arabic | `bg` | Bulgarian | | `bn` | Bengali | `bs` | Bosnian | `ca` | Catalan | | `cn` | Montenegrin | `cs` | Czech | `cy` | Welsh | | `da` | Danish | `de` | German | `de-AT` | German (Austria) | | `de-CH` | German (Switzerland) | `el` | Greek | `en` | English | | `en-GB` | English (UK) | `en-US` | English (US) | `es` | Spanish | | `es-CL` | Spanish (Chile) | `es-EC` | Spanish (Ecuador) | `et` | Estonian | | `eu` | Basque | `fa` | Persian | `fi` | Finnish | | `fr` | French | `fr-BE` | French (Belgium) | `fr-CA` | French (Canada) | | `ga` | Irish | `gd` | Scots Gaelic | `he` | Hebrew | | `hi` | Hindi | `hr` | Croatian | `hu` | Hungarian | | `hy` | Armenian | `id` | Indonesian | `is` | Icelandic | | `it` | Italian | `ja` | Japanese | `ka` | Georgian | | `kn` | Kannada | `ko` | Korean | `lt` | Lithuanian | | `lv` | Latvian | `mi` | Maori | `mk` | Macedonian | | `nb` | Norwegian Bokmål | `nl` | Dutch | `nl-BE` | Flemish | | `nn` | Norwegian Nynorsk | `no` | Norwegian | `pl` | Polish | | `pt` | Portuguese | `pt-BR` | Portuguese (Brazil) | `ro` | Romanian | | `ru` | Russian | `sk` | Slovak | `sl` | Slovenian | | `sq` | Albanian | `sr` | Serbian | `sv` | Swedish | | `sw` | Swahili | `th` | Thai | `tl` | Tagalog (Filipino) | | `tr` | Turkish | `uk` | Ukrainian | `ur` | Urdu | | `vi` | Vietnamese | `zh` | Chinese (Simplified) | `zh-Hant` | Chinese (Traditional) |

## Response `201`

Folder successfully created.

- object
  - `folderId` Schema (unresolved $ref)

## Other responses

- `default`: Standard error response.

---

[API](https://skmtc.dev/stonly/apis/stonly-public-api.md) - [All operations](https://skmtc.dev/stonly/apis/stonly-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stonly/apis/stonly-public-api/revisions/4ba5b03a634a?raw)