---
title: "Create a folder for a property"
method: POST
path: "/datainsights/v1.1/folders"
tags: ["Folders"]
---

# Create a folder for a property

`POST /datainsights/v1.1/folders`

## Request

- The document declares no server URL.
- Auth: HTTP bearer

Folders give the ability to the user to organize and find better their reports

**Notes**
- A Folder can not have the same name
- A Folder may have a parent or may not
- The max level of nested folders is 3. Below there is an example of the max level allowed

```
Financial
│
└───Bar
    │
    └───Food

```

## Headers

- `X-PROPERTY-ID` integer, required

## Request body

- Folder
  - `id` integer, required: Folder Id
  - `name` string, required: Folder Name
  - `description` string: Folder description
  - `parent_id` integer, nullable, required: Id of the Parent Folder

## Response `201`

Created

- Folder
  - `id` integer, required: Folder Id
  - `name` string, required: Folder Name
  - `description` string: Folder description
  - `parent_id` integer, nullable, required: Id of the Parent Folder

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `409`: Conflict
- `500`: Internal Server Error

---

[API](https://skmtc.dev/cloudbeds/apis/data-insights-api.md) - [All operations](https://skmtc.dev/cloudbeds/apis/data-insights-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudbeds/apis/data-insights-api/revisions/0a16807149c2?raw)