Skip to main content
PUT
/
crm
/
v3
/
lists
/
folders
/
move-list
Moves a list to a given folder
curl --request PUT \
  --url https://api.hubapi.com/crm/v3/lists/folders/move-list \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "listId": "<string>",
  "newFolderId": "<string>"
}
'
This response has no body data.

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.

Body

application/json
listId
string
required

The Id of the list to move.

newFolderId
string
required

The Id of folder to move the list to, the root folder is Id 0.

Response

Last modified on December 16, 2025