---
schema_version: "1"
id: 876d35158927114f7a16bf2a964d1987a124be933703e8e7afafdc56097bd592
title: Manage Content Folders in Marketing Cloud Next
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/mc-core/guide/mc-manage-content/mc-manage-content-folders.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud-growth/guide/mc-manage-content-folders.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: bddc4665eb4dd2db196f072a07803b840fad1258616e7063bd828f2789313911
products:
  - Marketing Cloud Next
  - Marketing Cloud
---
# Manage Content Folders in Marketing Cloud Next

To organize content in a Marketing Cloud Next content workspace, use the `folders` endpoints in Connect API. Create folders under a parent folder, retrieve folder details, rename standard folders, and delete empty folders.

## Create a Folder

To create a folder, issue a POST request to the `/services/data/{apiVersion}/connect/cms/folders` endpoint.

| Property         | Data Type | Description                                                                                                                                                                                               |
| ---------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name`           | string    | Required. The folder name. Names must start with a letter. They can't contain leading or trailing white space, and can't contain `--`, `__`, `.`, `\`, `/`, or `:`. The maximum length is 255 characters. |
| `parentFolderId` | string    | Required. The ID of the parent folder where you create the folder.                                                                                                                                        |

This sample request creates a folder under an existing parent folder.

```json
POST /services/data/{apiVersion}/connect/cms/folders HTTP/1.1
Host: {subdomain}.my.salesforce.com
Content-Type: application/json
Authorization: Bearer YOUR_BEARER_TOKEN

{
  "name": "Q4 Promotional Emails",
  "parentFolderId": "9PuSB000002KUDo0AO"
}
```

For a successful request, the response includes the new folder, its parent hierarchy, and other metadata.

```json
{
  "createdBy": "005SB00000eaki1YAA",
  "createdDate": "2026-07-30T15:04:32.000Z",
  "folderHierarchy": [
    {
      "folderType": "System",
      "id": "9PuSB000002aY6r0AE",
      "name": "Messaging Workspace_marketing",
      "parentFolderId": null
    }
  ],
  "folderType": "Standard",
  "id": "9PuSB000002yr570AA",
  "isShared": false,
  "lastModifiedBy": "005SB00000eaki1YAA",
  "lastModifiedDate": "2026-07-30T15:04:32.000Z",
  "name": "Q4 Promotional Emails",
  "parentFolderId": "9PuSB000002aY6r0AE"
}
```

## Retrieve a Folder

To retrieve a folder, issue a GET request to the `/services/data/{apiVersion}/connect/cms/folders/{folderId}` endpoint. Replace `{folderId}` with the 18-character ID of the folder.

```json
GET /services/data/{apiVersion}/connect/cms/folders/9PuSB000002yr570AA HTTP/1.1
Host: {subdomain}.my.salesforce.com
Authorization: Bearer YOUR_BEARER_TOKEN
```

The response includes the folder details and the chain of folders from the root folder to the requested folder.

## Rename a Folder

To rename a standard folder, issue a PATCH request to the `/services/data/{apiVersion}/connect/cms/folders/{folderId}` endpoint. Include only the `name` property in the request body.

```json
PATCH /services/data/{apiVersion}/connect/cms/folders/9PuSB000002yr570AA HTTP/1.1
Host: {subdomain}.my.salesforce.com
Content-Type: application/json
Authorization: Bearer YOUR_BEARER_TOKEN

{
  "name": "Renamed Assets"
}
```

**note:** Update only a folder's `name`. You can't move a folder to a different parent folder or rename a root folder.

## Delete a Folder

To delete a folder, issue a DELETE request to the `/services/data/{apiVersion}/connect/cms/folders/{folderId}` endpoint.

```json
DELETE /services/data/{apiVersion}/connect/cms/folders/9PuSB000002yr570AA HTTP/1.1
Host: {subdomain}.my.salesforce.com
Authorization: Bearer YOUR_BEARER_TOKEN
```

A successful request returns `204 No Content` and no response body.

**important:** You can delete only empty, non-root folders. If you try to delete a root folder or a folder that isn't empty, the API returns an HTTP 400 response.

## See Also

- [Manage Content Workspaces](https://developer.salesforce.com/docs/marketing/marketing-cloud-growth/guide/mc-manage-content-workspaces.md)
- [Create and Manage Emails](https://developer.salesforce.com/docs/marketing/marketing-cloud-growth/guide/mc-manage-content-emails.md)
- API Reference: [Folders](/docs/marketing/marketing-cloud-growth/references/mc-next-folder)