HUhubspot
Folders

Create folder

Changed on

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/folders

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/files/2026-09/folders
  • Auth
    OAuth 2
    Authorization code: https://app.hubspot.com/oauth/authorize
    Token URL: https://api.hubapi.com/oauth/v1/token scopes: files.ui_hidden.write

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.

Changes

  • 2026-09551d24894509Revision changes
    • info

      api tag Folders added

    • info

      api tag Advanced removed

  • 2026-096e0d1e97cb30Revision changes
    • info

      the security scope files.ui_hidden.write was added to the endpoint's security scheme oauth2

    • info

      the security scope files.write was removed from the endpoint's security scheme oauth2