---
title: "POST /v1/{+parent}/folders"
method: POST
path: "/v1/{+parent}/folders"
tags: ["projects"]
---

# POST /v1/{+parent}/folders

`POST /v1/{+parent}/folders`

Creates a new Folder in a given project and location.

## Path parameters

- `parent` string, required

## Request body

- Folder — Represents a Dataform Folder. This is a resource that is used to organize Files and other Folders and provide hierarchical access controls.
  - `name` string — Identifier. The Folder's name.
  - `creatorIamPrincipal` string — Output only. The IAM principal identifier of the creator of the Folder.
  - `updateTime` string, google-datetime — Output only. The timestamp of when the Folder was last updated.
  - `teamFolderName` string — Output only. The resource name of the TeamFolder that this Folder is associated with. This should take the format: projects/{project}/locations/{location}/teamFolders/{teamFolder}. If this is not set, the Folder is not associated with a TeamFolder and is a UserFolder.
  - `displayName` string — Required. The Folder's user-friendly name.
  - `containingFolder` string — Optional. The containing Folder resource name. This should take the format: projects/{project}/locations/{location}/folders/{folder}, projects/{project}/locations/{location}/teamFolders/{teamFolder}, or just "" if this is a root Folder. This field can only be updated through MoveFolder.
  - `createTime` string, google-datetime — Output only. The timestamp of when the Folder was created.
  - `internalMetadata` string — Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/dataform.md) · [All operations](https://skmtc.net/google/apis/dataform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/dataform/versions/b9dafc69d5c5/schema)