Put /crm/v3/lists/folders/{folder Id}/move/{new Parent Folder Id} /crm/v3/lists/folders/{folder Id}/move/{new Parent Folder Id}

Moves a folder

PUT/crm/v3/lists/folders/{folderId}/move/{newParentFolderId}

Use it in a workflow

Add a step and choose the HubSpot connector.
Pick the Put /crm/v3/lists/folders/{folder Id}/move/{new Parent Folder Id} /crm/v3/lists/folders/{folder Id}/move/{new Parent Folder Id} action (under Lists).
Fill in the fields below, then reference the result from later steps as {{putCrmV3ListsFoldersFolderIdMoveNewParentFolderIdCrmV3ListsFoldersFolderIdMoveNewParentFolderId.response.data}}.

Request

Path parameters

folderIdstringrequired

The ID of the folder to move

newParentFolderIdstringrequired

The ID for the target parent folder.

Response

Returns 200 with an object. Read it in later steps with {{putCrmV3ListsFoldersFolderIdMoveNewParentFolderIdCrmV3ListsFoldersFolderIdMoveNewParentFolderId.response.data.<field>}}.

folderobject

childListsarray<integer (int32)>required

An array of list Id's contained in this folder.

childNodesarray<object>required

createdAtstring (date-time)

The time the folder was created at.

idstringrequired

The Id of the folder.

namestring

The name of the folder.

parentFolderIdstringrequired

The Id of the folder this folder is in, the root folder is represented as 0.

updatedAtstring (date-time)

The time the folder was last updated at.

updatedContentsAtstring (date-time)

The time that the contents of the folder was last updated at.

userIdinteger (int32)

The user Id of the owner of the folder.

json

{
  "folder": {
    "childLists": [
      0
    ],
    "childNodes": [
      {}
    ],
    "id": "string",
    "parentFolderId": "string",
    "createdAt": "2025-01-01T00:00:00Z",
    "name": "string",
    "updatedAt": "2025-01-01T00:00:00Z",
    "updatedContentsAt": "2025-01-01T00:00:00Z",
    "userId": 0
  }
}

Need more? See the HubSpot guide for connection setup and behaviour shared by every action.

Was this page helpful?