---
title: "POST /accounts/{AwsAccountId}/namespaces/{Namespace}/groups"
method: POST
path: "/accounts/{AwsAccountId}/namespaces/{Namespace}/groups"
---

# POST /accounts/{AwsAccountId}/namespaces/{Namespace}/groups

`POST /accounts/{AwsAccountId}/namespaces/{Namespace}/groups`

Use the `CreateGroup` operation to create a group in Amazon QuickSight. You can create up to 10,000 groups in a namespace. If you want to create more than 10,000 groups in a namespace, contact AWS Support.

The permissions resource is `arn:aws:quicksight:<your-region>:_<relevant-aws-account-id>_:group/default/_<group-name>_` .

The response is a group object.

## Path parameters

- `AwsAccountId` string, required
- `Namespace` string, required

## Request body

- object
  - `GroupName` string, required — A name for the group that you want to create.
  - `Description` string — A description for the group that you want to create.

## Response `200`

Success

- CreateGroupResponse — The response object for this operation.
  - `Group` object — The name of the group.
    - `Arn` string — The Amazon Resource Name (ARN) for the group.
    - `GroupName` string — The name of the group.
    - `Description` string — The group description.
    - `PrincipalId` string — The principal ID of the group.
  - `RequestId` string — The Amazon Web Services request ID for this operation.
  - `Status` integer — The HTTP status of the request.

## Other responses

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

---

[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)