---
title: "Move Folder"
method: PUT
path: "/crm/lists/2026-09/folders/{folderId}/move/{newParentFolderId}"
tags: ["Basic"]
---

# Move Folder

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

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/crm/lists/2026-09/folders/{folderId}/move/{newParentFolderId}`
- 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`

Move a folder to a new parent folder within the CRM lists. This operation is useful for reorganizing your folder structure by changing the parent folder of a specified folder.

## Path parameters

- `folderId` string, required
- `newParentFolderId` string, required

## 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/move/:newParentFolderId/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)