---
title: "POST /accounts/{accountId}/users#operation=create"
method: POST
path: "/accounts/{accountId}/users#operation=create"
---

# POST /accounts/{accountId}/users#operation=create

`POST /accounts/{accountId}/users#operation=create`

Creates a user under the specified Amazon Chime account.

## Path parameters

- `accountId` string, required

## Query parameters

- `operation` 'create', required

## Request body

- object
  - `Username` string — The user name.
  - `Email` string, password — The user's email address.
  - `UserType` 'PrivateUser' | 'SharedDevice' — The user type.

## Response `201`

Success

- CreateUserResponse
  - `User` object — The user on the Amazon Chime account.
    - `UserId` string, required — The user ID.
    - `AccountId` string — The Amazon Chime account ID.
    - `PrimaryEmail` string, password — The primary email address of the user.
    - `PrimaryProvisionedNumber` string, password — The primary phone number associated with the user.
    - `DisplayName` string, password — The display name of the user.
    - `LicenseType` 'Basic' | 'Plus' | 'Pro' | 'ProTrial' — The license type for the user.
    - `UserType` 'PrivateUser' | 'SharedDevice' — The user type.
    - `UserRegistrationStatus` 'Unregistered' | 'Registered' | 'Suspended' — The user registration status.
    - `UserInvitationStatus` 'Pending' | 'Accepted' | 'Failed' — The user invite status.
    - `RegisteredOn` string, date-time — Date and time when the user is registered, in ISO 8601 format.
    - `InvitedOn` string, date-time — Date and time when the user is invited to the Amazon Chime account, in ISO 8601 format.
    - `AlexaForBusinessMetadata` object — The Alexa for Business metadata.
      - `IsAlexaForBusinessEnabled` boolean — Starts or stops Alexa for Business.
      - `AlexaForBusinessRoomArn` string, password — The ARN of the room resource.
    - `PersonalPIN` string — The user's personal meeting PIN.

## Other responses

- `480` — UnauthorizedClientException
- `481` — NotFoundException
- `482` — ConflictException
- `483` — ForbiddenException
- `484` — BadRequestException
- `485` — ThrottledClientException
- `486` — ServiceUnavailableException
- `487` — ServiceFailureException

---

[API](https://skmtc.net/aws/apis/chime.md) · [All operations](https://skmtc.net/aws/apis/chime/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/chime/revisions/40da18840201/schema)