---
title: "POST /app-instance-users"
method: POST
path: "/app-instance-users"
---

# POST /app-instance-users

`POST /app-instance-users`

Creates a user under an Amazon Chime <code>AppInstance</code>. The request consists of a unique <code>appInstanceUserId</code> and <code>Name</code> for that user.

## Request body

- object
  - `AppInstanceArn` string, required — The ARN of the <code>AppInstance</code> request.
  - `AppInstanceUserId` string, password, required — The user ID of the <code>AppInstance</code>.
  - `Name` string, password, required — The user's name.
  - `Metadata` string, password — The request's metadata. Limited to a 1KB string in UTF-8.
  - `ClientRequestToken` string, required — The unique ID of the request. Use different tokens to request additional <code>AppInstances</code>.
  - `Tags` Tag[] — Tags assigned to the <code>AppInstanceUser</code>.
    - `Key` string, password, required — The key in a tag.
    - `Value` string, password, required — The value in a tag.
  - `ExpirationSettings` object — Determines the interval after which an <code>AppInstanceUser</code> is automatically deleted.
    - `ExpirationDays` integer — The period in days after which an <code>AppInstanceUser</code> will be automatically deleted.
    - `ExpirationCriterion` 'CREATED_TIMESTAMP' — Specifies the conditions under which an <code>AppInstanceUser</code> will expire.

## Response `201`

Success

- CreateAppInstanceUserResponse
  - `AppInstanceUserArn` string — The user's ARN.

## Other responses

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

---

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