Manage Content Workspaces in Marketing Cloud Next

Use content workspaces to organize and store your marketing content, such as emails and email templates. Use the CMS Spaces endpoints in Connect API to create and manage workspaces.

Create a Workspace

To create a workspace, issue a POST request to the /services/data/{apiVersion}/connect/cms/spaces endpoint.

Property	Data Type	Description
`name`	string	Required. The workspace name.
`description`	string	A description of the workspace.
`defaultLanguage`	string	The default language locale for the workspace, such `ja_JP`.
`spaceType`	string	The type of workspace to create. Possible values are `Marketing` or `Content`.
`apiName`	string	An API name for the workspace.

This sample request shows how to create a marketing workspace.

1POST /services/data/{apiVersion}/connect/cms/spaces HTTP/1.1
2Host: {subdomain}.my.salesforce.com
3Content-Type: application/json
4Authorization: Bearer YOUR_BEARER_TOKEN
5
6{
7  "name": "MCN Workspace",
8  "description": "Content for MCN Workspace",
9  "defaultLanguage": "en_US",
10  "spaceType": "Marketing",
11  "apiName": "MCN_Workspace"
12}

If the request is successful, the response includes metadata about the workspace.

1{
2  "apiName": "MCN_Workspace",
3  "createdBy": "005QZ000004x1CHYAY",
4  "createdDate": "2026-03-23T18:01:08.000Z",
5  "defaultLanguage": "en_US",
6  "description": "Content for MCN Workspace",
7  "fullyQualifiedName": "MCN_Workspace--marketing",
8  "id": "0ZuQZ0000004YSv0AM",
9  "isEnhancedSpace": true,
10  "isFlowOrchestrationEnabled": true,
11  "lastModifiedBy": "005QZ000004x1CHYAY",
12  "lastModifiedDate": "2026-03-23T23:47:36.000Z",
13  "name": "MCN Workspace",
14  "rootFolderId": "9PuQZ0000004bLx0AI",
15  "spaceType": {
16    "apiName": "marketing"
17  }
18}

Copy the value of the id property. You use this ID to create content in the workspace.

Retrieve a Workspace by ID

To retrieve details about a specific workspace, issue a GET request to the /services/data/{apiVersion}/connect/cms/spaces/{contentSpaceOrFolderId} endpoint.

1GET /services/data/{apiVersion}/connect/cms/spaces/0ZuQZ0000004YSv0AM HTTP/1.1
2Host: {subdomain}.my.salesforce.com
3Authorization: Bearer YOUR_BEARER_TOKEN

If the request is successful, the response includes workspace details.

1{
2  "apiName": "MCN_Workspace",
3  "createdBy": "005QZ000004x1CHYAY",
4  "createdDate": "2026-03-23T18:01:08.000Z",
5  "defaultLanguage": "en_US",
6  "description": "Content for MCN Workspace",
7  "id": "0ZuQZ0000004YSv0AM",
8  "name": "MCN Workspace",
9  "rootFolderId": "9PuQZ0000004bLx0AI",
10  "spaceType": {
11    "apiName": "marketing"
12  }
13}

Retrieve All Workspaces

To retrieve a list of all workspaces, issue a GET request to the /services/data/{apiVersion}/connect/cms/spaces endpoint. This table lists the query parameters that you can include in the request.

Query Parameter	Data Type	Description
`nameFragment`	string	A string of text to filter results by. The API returns only the workspaces with names that contain this value.
`page`	int	The page number of results to return. The first page of results is page `0`.
`pageSize`	int	The number of results to return per page. The maximum value is 250. The default value is `25`.

This code example shows how to retrieve a list of all workspaces.

1GET /services/data/{apiVersion}/connect/cms/spaces?pageSize=25 HTTP/1.1
2Host: {subdomain}.my.salesforce.com
3Authorization: Bearer YOUR_BEARER_TOKEN

If the request is successful, the response includes a list of workspaces.

1{
2  "currentPageUrl": "/services/data/v67.0/connect/cms/spaces?page=0&pageSize=250",
3  "nextPageUrl": null,
4  "previousPageUrl": null,
5  "spaces": [
6    {
7      "apiName": "MCN_Workspace",
8      "id": "0ZuQZ0000004YSv0AM",
9      "name": "MCN Workspace",
10      "spaceType": {
11        "apiName": "marketing"
12      }
13    }
14  ],
15  "total": 1
16}

Use the id value from a workspace to create content in that workspace.

Update a Workspace

To update a workspace name or description, issue a PATCH request to the /services/data/{apiVersion}/connect/cms/spaces/{contentSpaceOrFolderId} endpoint. In the body of the request, include only the fields that you want to update.

You can’t change the ID of the workspace in a PATCH request.

Note

This sample request shows how to change the name and description of a workspace.

1PATCH /services/data/{apiVersion}/connect/cms/spaces/0ZuQZ0000004YSv0AM HTTP/1.1
2Host: {subdomain}.my.salesforce.com
3Content-Type: application/json
4Authorization: Bearer YOUR_BEARER_TOKEN
5
6{
7  "name": "Updated Workspace Name",
8  "description": "Updated description for the workspace"
9}

Manage Content Workspaces in Marketing Cloud Next

Create a Workspace

Retrieve a Workspace by ID

Retrieve All Workspaces

Update a Workspace

See Also