---
title: "POST /applications/{applicationId}/users"
method: POST
path: "/applications/{applicationId}/users"
---

# POST /applications/{applicationId}/users

`POST /applications/{applicationId}/users`

Creates a universally unique identifier (UUID) mapped to a list of local user ids within an application.

## Path parameters

- `applicationId` string, required

## Request body

- object
  - `userId` string, required — The user emails attached to a user mapping.
  - `userAliases` UserAlias[] — The list of user aliases in the mapping.
    - `indexId` string — The identifier of the index that the user aliases are associated with.
    - `dataSourceId` string — The identifier of the data source that the user aliases are associated with.
    - `userId` string, required — The identifier of the user id associated with the user aliases.
  - `clientToken` string — A token that you provide to identify the request to create your Amazon Q Business user mapping.

## Response `200`

Success

- CreateUserResponse

## Other responses

- `480` — InternalServerException
- `481` — ResourceNotFoundException
- `482` — ConflictException
- `483` — ThrottlingException
- `484` — ValidationException
- `485` — AccessDeniedException
- `486` — ServiceQuotaExceededException

---

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