# Create Folder

> Windows | Cross-platform

## Project compatibility

Windows | Cross-platform

## Overview

| Description | API Method | API Path |
| --- | --- | --- |
| This operation creates a new folder in a specified parent directory. Optional settings allow configuration of sync state (legacy functionality) and folder upload email access permissions. | POST | /folders |

## Input

| Parameter | Description | Data Type |
| --- | --- | --- |
| Folder name | The name of the folder being created. | string |
| Parent Folder | The parent folder where the new folder will be created. | data list |
| Sync state | Specifies whether the folder should be synced to a user’s device. This was used by Box Sync (discontinued) and is not used by Box Drive. | options |
| Folder Upload email access | Defines whether uploading via the folder’s unique email address is enabled and who is permitted to use it. | options |

## Output

| Parameter | Description | Data Type |
| --- | --- | --- |
| ID | The unique identifier of the newly created folder | string |
| Create Folder | The full response payload associated with the create folder activity | object |

:::note
* In API workflows, a single response object is returned as the output. Any required fields can be extracted directly from this object.
* In RPA workflows, some output parameters may differ, but the necessary values can still be retrieved from the response object even if they are not explicitly exposed.
:::