There's a new version of the HubSpot API

We're also working on a new documentation website, you're invited to check it out and give us your feedback.

Get a Folder by ID

Last updated May 31, 2023

GET /filemanager/api/v2/folders/:folder_id

Method Details

HTTP Methods:


Response Format:


Requires Authentication?


Rate Limited?





Marketing & CRM

Required Scope:


Get the details for a specific 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 folder

Example Usage and Result

Hit this URL with a HTTP method of GET

JSON Fields returned in the response

Parameter name Type Description
created long When the folder was first created, in milliseconds since the epoch
deleted_at long When the folder was deleted, in milliseconds since the epoch. Zero if the folder was never deleted. Use a DELETE request to delete the folder, do not set this directly.
full_path string The full path to the folder, with all the parent folder paths included
id string The unique id of the folder
name string The name of the folder
parent_folder_id string The id of the parent folder
updated long When the folder was last updated, in milliseconds since the epoch