---
title: "Create folder"
method: POST
path: "/v1/folders"
tags: ["Folders"]
---

# Create folder

`POST /v1/folders`

Create a new folder in your Dovetail workspace. Folders organize projects, docs, channels, and other content into a hierarchical structure.

Optionally provide a `parent_folder_id` to nest the folder inside an existing folder. If omitted, the folder is created at the workspace root level.

Returns the newly created folder object.

> 🚧 Permissions
>
> Please check you have the relevant permissions required to access this resource. This may include specific permissions on the object itself or its parent, or having the correct user role if you're making updates.

## Request body

- object
  - `title` string, required — The folder's title.
  - `parent_folder_id` string — The ID of the parent folder. If omitted, the folder is created at the root level.

## Response `201`

201

- object
  - `data` object, required
    - `id` string, required
    - `url` string — The URL of this resource in the Dovetail web app. This field is experimental and may change without notice.
    - `title` string, required
    - `type` 'folder', required
    - `created_at` string, required
    - `parent_folder` object, nullable, required
      - `id` string, required
    - `folders` object[], nullable, required
      - `id` string, required

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `404` — 404
- `422` — 422
- `429` — 429
- `500` — 500

---

[API](https://skmtc.net/dovetail/apis/dovetail-public-api.md) · [All operations](https://skmtc.net/dovetail/apis/dovetail-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dovetail/dovetail-public-api/versions/4107f5fdf8b2/schema)