Method Details
HTTP Methods:
GET
Response Format:
json
Requires Authentication?
Yes
Rate Limited?
Headers
Products:
Marketing & CRM
Required Scope:
Get the metadata for the folders in file manager.
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.
HTTP Methods:
GET
Response Format:
json
Requires Authentication?
Yes
Rate Limited?
Headers
Products:
Marketing & CRM
Required Scope:
Get the metadata for the folders in file manager.
| 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. |
| Parameter name | Description |
|---|---|
| limit | The number of items to return. Defaults to 20 |
| offset | The offset set to start returning rows from. Defaults to 0. |
| deleted_at | Get folders deleted on or after a certain date. Available filers are exact, range, gt, gte, lt, lte. Use the parameter followed by two underscores and the filter of choice. For example deleted_at__lt=1431489600000 will return all files deleted before May 15, 2015. Filters take unix timestamps in milliseconds. |
| id | Get a specific folder. |
| name | Get folders with a certain naming convention. Available filters are exact, contains, icontains. Use the paramter followed by two underscores and the filter of choice. For example name__icontains=abc will return all folders that have the characters abc (in a row) in the name. |
| parent_folder_id | Get all folders in a specific folder. Available filers are exact, range, gt, gte, lt, lte. Use the parameter followed by two underscores and the filter of choice. For example parent_folder_id__lte=2857188310 will return all folders with an id less than or equal to 2857188310. |
Hit this URL with a HTTP method of GET http://api.hubapi.com/filemanager/api/v2/folders
| 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 a 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 |