---
title: "Create folder"
method: POST
path: "/files/2026-03/folders"
tags: ["Files"]
---

# Create folder

`POST /files/2026-03/folders`

Creates a folder.

## Request body

- FilesFolderInput
  - `name` string, required — Desired name for the folder.
  - `parentFolderId` string — FolderId of the parent of the created folder. If not specified, the folder will be created at the root level. parentFolderId and parentFolderPath cannot be set 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 `201`

successful operation

- FilesFolder
  - `archived` boolean, required — Marks whether the folder is deleted or not.
  - `archivedAt` string, date-time — Timestamp of folder deletion.
  - `createdAt` string, date-time, required — Timestamp of folder creation.
  - `id` string, required — ID of the folder.
  - `name` string — Name of the folder.
  - `parentFolderId` string — ID of the parent folder.
  - `path` string — Path of the folder in the file manager.
  - `updatedAt` string, date-time, required — Timestamp of the latest update to the folder.

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/hubspot/apis/hubspot-api-specification.md) · [All operations](https://skmtc.net/hubspot/apis/hubspot-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/hubspot-api-specification/revisions/f9c7181056c5/schema)