Advanced

Create folder

Create a new folder in the HubSpot file manager. This endpoint allows you to organize files by creating folders, which can be nested within other folders by specifying a parent folder ID or path.

post/files/2026-09-beta/folders

Request body

namestring required

The name of the folder to be created. This is a required string property.

parentFolderIdstring

The ID of the parent folder under which the new folder will be created. This is an optional string field.

parentPathstring

The path of the parent folder under which the new folder will be created. This is an optional string property.

Response

successful operation

archivedboolean required

A boolean indicating whether the folder is archived.

archivedAtstring date-time

The date and time when the folder was archived, in ISO 8601 format.

createdAtstring date-time required

The date and time when the folder was created, in ISO 8601 format.

idstring required

The unique ID for the folder, represented as a string.

namestring

The name of the folder, represented as a string.

parentFolderIdstring

The unique identifier of the parent folder, represented as a string.

pathstring

The path of the folder within the file system, represented as a string.

updatedAtstring date-time required

The date and time when the folder was last updated, in ISO 8601 format.