There's a new version of the HubSpot API

As of November 30, 2022, HubSpot API keys are no longer a supported authentication method for accessing HubSpot APIs. Instead, you should use a private app access token or OAuth to authenticate API calls. Learn more about this change and how to migrate an API key integration to use a private app instead.

Move or Rename a folder

Last updated June 17, 2020

POST /filemanager/api/v2/folders/:folder_id/move-folder

Method Details

HTTP Methods:

POST

Content Type:

application/json

Response Format:

json

Requires Authentication?

Yes

Rate Limited?

Yes

Headers

User-Agent

Products:

Marketing & CRM

Required Scope:

files

This endpoint allows you to rename a folder or change its' location.

To rename it, pass an updated name parameter. To move it, pass an updated parent_folder_id. Use a parent_folder_id of null to move it to the root folder.

Required Parameters How to use Description
OAuth access token or private app access token Authorization: Bearer {token} header Used to authenticate the request. Please see this page for more details about authentication.
folder_id Used in the request URL Unique identifier for a particular blog

Allowed JSON Fields in the body

Parameter name Type Description
parent_folder_id integer The id of the new folder to move the folder into.
name string The new name of the folder.