---
title: "POST /app-instances"
method: POST
path: "/app-instances"
---

# POST /app-instances

`POST /app-instances`

Creates an Amazon Chime SDK messaging <code>AppInstance</code> under an AWS account. Only SDK messaging customers use this API. <code>CreateAppInstance</code> supports idempotency behavior as described in the AWS API Standard.

## Request body

- object
  - `Name` string, password, required — The name of the <code>AppInstance</code>.
  - `Metadata` string, password — The metadata of the <code>AppInstance</code>. Limited to a 1KB string in UTF-8.
  - `ClientRequestToken` string, password, required — The <code>ClientRequestToken</code> of the <code>AppInstance</code>.
  - `Tags` Tag[] — Tags assigned to the <code>AppInstance</code>.
    - `Key` string, password, required — The key of the tag.
    - `Value` string, password, required — The value of the tag.

## Response `201`

Success

- CreateAppInstanceResponse
  - `AppInstanceArn` string — The Amazon Resource Number (ARN) of the <code>AppInstance</code>.

## 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.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)