# Create a folder

Creates a new folder at the top level of the project project_id.

The new folder is supplied as a JSON object in the request body supplying only the name of the new folder.

Note: it is not possible to create a new folder together with a new script (or sub-folder) in the same request.
Instead, a first request must be made to create a new folder, and then subsequent requests can be used to populate it with content.

Endpoint: POST /projects/{project_id}/folders
Version: 1.0

## Path parameters:

  - `project_id` (integer, required)
    The project ID.

## Query parameters:

  - `insert` (string)
    Controls where the folder will be created within the top-level items

first (default) — the folder is placed at the top of the project.  
last — the folder is placed at the end of the project's contents.  
N - integer — the folder is placed after the Nth item in the project.

## Request fields (application/json):

  - `name` (string)
    The name of the new folder


## Response 200 fields