---
title: "POST /accounts/{accountId}/users"
method: POST
path: "/accounts/{accountId}/users"
---

# POST /accounts/{accountId}/users

`POST /accounts/{accountId}/users`

Updates user details within the <a>UpdateUserRequestItem</a> object for up to 20 users for the specified Amazon Chime account. Currently, only <code>LicenseType</code> updates are supported for this action.

## Path parameters

- `accountId` string, required

## Request body

- object
  - `UpdateUserRequestItems` UpdateUserRequestItem[], required — The request containing the user IDs and details to update.
    - `UserId` string, required — The user ID.
    - `LicenseType` 'Basic' | 'Plus' | 'Pro' | 'ProTrial' — The user license type.
    - `UserType` 'PrivateUser' | 'SharedDevice' — The user type.
    - `AlexaForBusinessMetadata` object — The Alexa for Business metadata.
      - `IsAlexaForBusinessEnabled` boolean — Starts or stops Alexa for Business.
      - `AlexaForBusinessRoomArn` string, password — The ARN of the room resource.

## Response `200`

Success

- BatchUpdateUserResponse
  - `UserErrors` UserError[] — If the <a>BatchUpdateUser</a> action fails for one or more of the user IDs in the request, a list of the user IDs is returned, along with error codes and error messages.
    - `UserId` string — The user ID for which the action failed.
    - `ErrorCode` 'BadRequest' | 'Conflict' | 'Forbidden' | 'NotFound' | 'PreconditionFailed' | 'ResourceLimitExceeded' | 'ServiceFailure' | 'AccessDenied' | 'ServiceUnavailable' | 'Throttled' | 'Throttling' | 'Unauthorized' | 'Unprocessable' | 'VoiceConnectorGroupAssociationsExist' | 'PhoneNumberAssociationsExist' — The error code.
    - `ErrorMessage` string — The error message.

## Other responses

- `480` — UnauthorizedClientException
- `481` — NotFoundException
- `482` — ForbiddenException
- `483` — BadRequestException
- `484` — ThrottledClientException
- `485` — ServiceUnavailableException
- `486` — 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/versions/40da18840201/schema)