Skip to main content
PUT
/
crm
/
v3
/
lists
/
folders
/
{folderId}
/
rename
Rename a folder
curl --request PUT \
  --url https://api.hubapi.com/crm/v3/lists/folders/{folderId}/rename \
  --header 'Authorization: Bearer <token>'
{
  "folder": {
    "childLists": [
      123
    ],
    "childNodes": "<array>",
    "id": "<string>",
    "parentFolderId": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "name": "<string>",
    "updatedAt": "2023-11-07T05:31:56Z",
    "updatedContentsAt": "2023-11-07T05:31:56Z",
    "userId": 123
  }
}

Supported products

Requires one of the following products or higher.
Marketing HubMarketing Hub -Free
Sales HubSales Hub -Free
Service HubService Hub -Free
Content HubContent Hub -Free
Data HubData Hub -Free

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

folderId
string
required

The ID of the folder to rename

Query Parameters

newFolderName
string

The new name of the folder.

Response

successful operation

folder
object
required
Last modified on December 16, 2025