---
title: "Create folder"
method: POST
path: "/tests/folders"
---

# Create folder

`POST /tests/folders`

Create a folder. Pass `parentId` to nest it inside another folder, or leave it out for a top-level one. Folder names are for people to read: two folders may share a name, and everything that refers to a folder uses its id.

## Request body

- CreateFolder
  - `name` string, required — Display name, up to 60 characters.
  - `parentId` string, nullable — Nest the new folder inside this one. Omit it, or send `null`, for a top-level folder.

## Response `200`

Successful response

- object
  - `folderId` string — The unique identifier of the created folder.
  - `folder` Folder
    - `id` string — The id everything else refers to this folder by.
    - `name` string — Display name. Two folders may share one.
    - `parentId` string, nullable — The folder this one sits in, or `null` at the top level.
    - `path` string — The names from the top level down, joined with ` / `.
    - `testCount` integer — Tests in this folder, counting its subfolders.

## Other responses

- `400` — The name is empty or longer than 60 characters, or this organisation's tests are QA Studio no-code tests.
- `404` — The folder named as `parentId` does not exist.

---

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