Create folder

curl --request POST \
  --url https://api.hubapi.com/files/v3/folders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "parentFolderId": "<string>",
  "parentPath": "<string>"
}
'

{
  "archived": true,
  "createdAt": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "updatedAt": "2023-11-07T05:31:56Z",
  "archivedAt": "2023-11-07T05:31:56Z",
  "name": "<string>",
  "parentFolderId": "<string>",
  "path": "<string>"
}

POST

files

folders

Create folder

curl --request POST \
  --url https://api.hubapi.com/files/v3/folders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "parentFolderId": "<string>",
  "parentPath": "<string>"
}
'

{
  "archived": true,
  "createdAt": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "updatedAt": "2023-11-07T05:31:56Z",
  "archivedAt": "2023-11-07T05:31:56Z",
  "name": "<string>",
  "parentFolderId": "<string>",
  "path": "<string>"
}

Supported products

Required Scopes

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

Folder creation options

Object for creating a folder.

name

string

required

New name. If specified the folder's name and fullPath will change. All children of the folder will be updated accordingly.

parentFolderId

string

New parent folderId. If changed, the folder and all it's children will be moved into the specified folder. parentFolderId and parentFolderPath cannot be specified at the same time.

parentPath

string

Path of the parent of the created folder. If not specified the folder will be created at the root level. parentFolderPath and parentFolderId cannot be set at the same time.

Response

successful operation

archived

boolean

required

Marks whether the folder is deleted or not.

createdAt

string<date-time>

required

Timestamp of folder creation.

string

required

ID of the folder.

updatedAt

string<date-time>

required

Timestamp of the latest update to the folder.

archivedAt

string<date-time>

Timestamp of folder deletion.

name

string

New name. If specified the folder's name and fullPath will change. All children of the folder will be updated accordingly.

parentFolderId

string

New parent folderId. If changed, the folder and all it's children will be moved into the specified folder. parentFolderId and parentFolderPath cannot be specified at the same time.

path

string

Path of the folder in the file manager.

Last modified on February 12, 2026

⌘I