HUhubspot
Basic

Rename folder

Changed on

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.

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
    • 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
    • or 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
    • or 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
    • or 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
    • or 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
    • or 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

Path parameters

folderIdstring required

The unique identifier of the folder to be renamed.

Query parameters

newFolderNamestring

The new name for the folder. It should be a string representing the desired folder name.

Response

successful operation

Changes

  • 2026-09e1dd745172d1Revision changes
    • info

      the security scope crm.lists.write was added to the endpoint's security scheme oauth2

    • info

      the security scope cms.membership.access_groups.write was removed from the endpoint's security scheme oauth2

  • 2026-096d0e6dc36ca0Revision changes
    • info

      the security scope crm.lists.write was added to the endpoint's security scheme oauth2

    • info

      the security scope cms.membership.access_groups.write was removed from the endpoint's security scheme oauth2