---
title: "Rename folder"
method: PUT
path: "/crm/lists/2026-09/folders/{folderId}/rename"
tags: ["Basic"]
---

# Rename folder

`PUT /crm/lists/2026-09/folders/{folderId}/rename`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/crm/lists/2026-09/folders/{folderId}/rename`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.lists.write`, `crm.segments.read`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `cms.membership.access_groups.write`, `crm.lists.read`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.segments.read`, `crm.segments.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.lists.read`, `crm.segments.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.lists.read`, `crm.lists.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `cms.membership.access_groups.write`, `crm.segments.read`

Rename an existing folder in the CRM lists by specifying the folder's ID and the new desired name. This can be useful for organizing and updating folder structures within your account.

## Path parameters

- `folderId` string, required

## Query parameters

- `newFolderName` string

## Response `200`

successful operation

- ListFolderFetchResponse
  - `folder` PublicListFolder, required
    - `childLists` integer[], required: An array of strings, each representing the unique identifier of a list that is a direct child of this folder.
    - `childNodes` PublicListFolder[], required: An array of strings, each representing the unique identifier of a child node, which could be either a folder or a list.
    - `createdAt` string, date-time: The date and time when the folder was created, in ISO 8601 format.
    - `id` string, required: The unique identifier for the folder, represented as a string.
    - `name` string: The name of the folder, represented as a string.
    - `parentFolderId` string, required: The unique identifier of the parent folder, represented as a string. This indicates the hierarchical structure of folders.
    - `updatedAt` string, date-time: The date and time when the folder was last updated, in ISO 8601 format.
    - `updatedContentsAt` string, date-time: The date and time when the contents of the folder were last updated, in ISO 8601 format.
    - `userId` integer: The unique identifier of the user who created or last updated the folder, represented as a string.

## Other responses

- `default`: An error occurred.

## Changes

- **2026-10-10** (2026-09) `e1dd745172d1`: 2 info
  - the security scope `crm.lists.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `cms.membership.access_groups.write` was removed from the endpoint's security scheme `oauth2`
- **2026-09-07** (2026-09) `6d0e6dc36ca0`: 2 info
  - the security scope `crm.lists.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `cms.membership.access_groups.write` was removed from the endpoint's security scheme `oauth2`

[Operation history](https://skmtc.dev/hubspot/apis/crm-lists/changes/crm/lists/2026-09/folders/:folderId/rename/put.md)

---

[API](https://skmtc.dev/hubspot/apis/crm-lists.md) - [All operations](https://skmtc.dev/hubspot/apis/crm-lists/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/crm-lists/revisions/e1dd745172d1?raw)