---
schema_version: "1"
id: 105a45cd5a32bbe690e0a229b995b227766384a09bc68a7b4c0279ac07edf35d
title: Folder Collections
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/analytics/api_analytics/guides/reference/folders/analytics-api-folders-create.md
canonical_url: https://developer.salesforce.com/docs/analytics/salesforce-analytics-rest-api/guide/analytics-api-folders-create.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: cad432d7d79538c9f35346a80b42cb99cdaa6d68884451c2b98ea7b710382108
products:
  - Salesforce Reports and Dashboards REST API Developer Guide
  - analytics
---

# Folder Collections

Enables creation of report and dashboard folders and obtaining the list of folders.

The following user permissions are needed to access this resource.

POST:

-   Create Dashboard Folders (for dashboard folders)
-   Create Report Folders (for report folders)

GET:

-   View access to the folder

## Syntax

**URI:** `/services/data/v43.0/folders/`

**Formats:** JSON

**HTTP methods**

|Method|Description|
|------|-----------|
|`POST`|Creates a new folder with the specified name, label, and type.|
|`GET`|Gets the list of folders.|

## POST

Creates a new folder with the specified name, label, type, and parent ID (subfolders only).

`/services/data/v43.0/folders/`

**Request Body**

|Query Parameter Name|Group|Available Version|Values|Description|
|--------------------|-----|-----------------|------|-----------|
|`folder`|Object|42.0, 43.0|[FolderInputRepresentation](#folder-collections)|Specifies the folder name, label, type, and parent ID.|

**FolderInputRepresentation**

|Code|Type|Available Version|Description|
|----|----|-----------------|-----------|
|`label`|String|42.0|Folder display name.|
|`name`|String|42.0|Folder unique name. This is a mandatory field for admins; for non-admins, it is auto-generated.|
|`type`|[ConnectFolderTypeEnum](#folder-collections)|42.0|Defined by the type of entity the folder contains.|
|`parentId`|String|43.0|ID of the parent folder. This field is valid only for subfolders.|

**ConnectFolderTypeEnum**

|Type|Description|
|----|-----------|
|Dashboard|Dashboard folders.|
|Document|Document folders.|
|Email|Email folders.|
|Insights|Insights folders.|
|Reports|Reports folders.|

**Sample Request Body**

```nolang
{
  "label": "report_folder",
  "name": "report_folder1",
  "type": "report"
  "parentId": "00lxx000000fffffff"
}

```

**Sample Output Response**

```nolang
{
  "id" : "00lxx000000flSFAAY",
  "label" : "report_folder",
  "name" : "report_folder1",
  "shareRecipientsUrl" : "/services/data/v43.0/folders/00lxx000000flSFAAY/share-recipients?shareType=User&limit=100",
  "sharesUrl" : "/services/data/v43.0/folders/00lxx000000flSFAAY/shares",
  "supportedShareTypes" : [ "user", "role", "roleandsubordinates", "roleandsubordinatesinternal", "group", "portalrole", "portalroleandsubordinates", "customerportaluser" ],
  "type" : "report"
  "parentId" : "00lxx000000fffffff"

}

```

## GET

Gets the list of report and dashboard folders.

`/services/data/v43.0/folders/`

**Parameters**

|Field|Type|Available Version|Description|
|-----|----|-----------------|-----------|
|`type`|[ConnectFolderTypeEnum](#folder-collections)|43.0|Defined by the type of entity the folder contains. If not specified, returns all visible folders. If specified, returns visible folders of the specified type.|
|`page`|Integer|43.0|Integer that indicates which page of results to return. Default is 1.|
|`pageSize`|Integer|43.0|Integer that indicates how many results to return per page. Default is 10.|

**Output Payload**

[FolderCollectionRepresentation](#folder-collections)

**FolderCollectionRepresentation**

|Field|Type|Available Version|Description|
|-----|----|-----------------|-----------|
|`folders`|[FolderSummaryRepresentation](#folder-collections)|43.0|Collection of folders.|
|`totalSize`|Integer|43.0|Size of the folder collection.|
|`url`|ConnectUri|43.0|URL of the folder collection.|
|`nextPageurl`|ConnectUri|43.0|URL to the next page in the collection.|
|`previousPageurl`|ConnectUri|43.0|URL to the next page in the collection.|

**FolderSummaryRepresentation**

|Field|Type|Available Version|Description|
|-----|----|-----------------|-----------|
|`id`|ID|43.0|Unique identifier.|
|`label`|String|43.0|Display label.|
|`name`|String|43.0|Folder unique name.|
|`namespace`|String|43.0|Namespace prefix to differentiate custom object and field names from those in use by other organizations.|
|`type`|[ConnectFolderTypeEnum](#folder-collections)|43.0|Defined by the type of entity the folder contains.|
|`parentId`|ID|43.0|ID of the parent folder.|
|`url`|ConnectUri|43.0|URL of the folder.|
|`childrenUrl`|ConnectUri|43.0|URL that represents the first level subfolders of the specified folder.|
|`depth`|Int|43.0|Depth of the folder in the tree. A folder with depth 0 is the root folder.|

**Sample Output Response**

```nolang
{
  "folders" : [ {
    "childrenUrl" : "/services/data/v43.0/folders/00lRM000000jCWjYAM/children",
    "id" : "00lRM000000jCWjYAM",
    "label" : "Asia Sales",
    "name" : "Asia_Sales",
    "type" : "report",
    "url" : "/services/data/v43.0/folders/00lRM000000jCWjYAM"
  }, {
    "childrenUrl" : "/services/data/v43.0/folders/00lRM000000jDmNYAU/children",
    "id" : "00lRM000000jDmNYAU",
    "label" : "Europe Sales",
    "name" : "Europe_Sales",
    "type" : "report",
    "url" : "/services/data/v43.0/folders/00lRM000000jDmNYAU"
  }, {
    "childrenUrl" : "/services/data/v43.0/folders/00lRM000000jHKXYA2/children",
    "id" : "00lRM000000jHKXYA2",
    "label" : "North America Sales",
    "name" : "North_America_Sales",
    "type" : "report",
    "url" : "/services/data/v43.0/folders/00lRM000000jHKXYA2"
  } ],
  "totalSize" : 3,
  "url" : "/services/data/v43.0/folders?page=1&pageSize=10"
}
```