---
title: "POST /accounts/{AwsAccountId}/folders/{FolderId}"
method: POST
path: "/accounts/{AwsAccountId}/folders/{FolderId}"
---

# POST /accounts/{AwsAccountId}/folders/{FolderId}

`POST /accounts/{AwsAccountId}/folders/{FolderId}`

Creates an empty shared folder.

## Path parameters

- `AwsAccountId` string, required
- `FolderId` string, required

## Request body

- object
  - `Name` string — The name of the folder.
  - `FolderType` 'SHARED' — The type of folder. By default, <code>folderType</code> is <code>SHARED</code>.
  - `ParentFolderArn` string — <p>The Amazon Resource Name (ARN) for the parent folder.</p> <p> <code>ParentFolderArn</code> can be null. An empty <code>parentFolderArn</code> creates a root-level folder.</p>
  - `Permissions` ResourcePermission[] — <p>A structure that describes the principals and the resource-level permissions of a folder.</p> <p>To specify no permissions, omit <code>Permissions</code>.</p>
    - `Principal` string, required — <p>The Amazon Resource Name (ARN) of the principal. This can be one of the following:</p> <ul> <li> <p>The ARN of an Amazon QuickSight user or group associated with a data source or dataset. (This is common.)</p> </li> <li> <p>The ARN of an Amazon QuickSight user, group, or namespace associated with an analysis, dashboard, template, or theme. (This is common.)</p> </li> <li> <p>The ARN of an Amazon Web Services account root: This is an IAM ARN rather than a QuickSight ARN. Use this option only to share resources (templates) across Amazon Web Services accounts. (This is less common.) </p> </li> </ul>
    - `Actions` String[], required — The IAM action to grant or revoke permissions on.
  - `Tags` Tag[] — Tags for the folder.
    - `Key` string, required — Tag key.
    - `Value` string, required — Tag value.

## Response `200`

Success

- CreateFolderResponse
  - `Status` integer — The HTTP status of the request.
  - `Arn` string — The Amazon Resource Name (ARN) for the newly created folder.
  - `FolderId` string — The folder ID for the newly created folder.
  - `RequestId` string — The request ID for the newly created folder.

## Other responses

- `480` — ResourceNotFoundException
- `481` — InvalidParameterValueException
- `482` — ThrottlingException
- `483` — ResourceExistsException
- `484` — ConflictException
- `485` — UnsupportedUserEditionException
- `486` — AccessDeniedException
- `487` — LimitExceededException
- `488` — InternalFailureException

---

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