# CreateAppClient
<a name="API_CreateAppClient"></a>


|  | 
| --- |
| The AWS AppFabric for productivity feature is in preview and is subject to change. | 

Creates an AppClient.

**Topics**
+ [Request body](#API_CreateAppClient_request)
+ [Response elements](#API_CreateAppClient_response)

## Request body
<a name="API_CreateAppClient_request"></a>

The request accepts the following data in JSON format.


| Parameter | Description | 
| --- | --- | 
| **appName** | The name of the app.<br />Type: String<br />Length Constraints: Minimum length of 1. Maximum length of 255.<br />Required: Yes | 
| **clientToken** | Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a [UUID type of value](https://wikipedia.org/wiki/Universally_unique_identifier).<br />If you don't provide this value, then AWS generates a random one for you.<br />If you retry the operation with the same `ClientToken`, but with different parameters, the retry fails with an `IdempotentParameterMismatch` error.<br />Type: String<br />Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`<br />Required: No | 
| **customerManagedKeyIdentifier** | The ARN of the customer managed key generated by AWS Key Management Service. The key is used to encrypt the data.<br />If no key is specified, then an AWS managed key is used. A map of the key-value pairs of the tag or tags to assign to the resource.<br />For more information about AWS owned keys and customer managed keys, see [Customer keys and AWS keys](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-mgmt) in the *AWS Key Management Service Developer Guide*.<br />Type: String<br />Length Constraints: Minimum length of 1. Maximum length of 1011.<br />Pattern: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`<br />Required: No | 
| **description** | A description for the app.<br />Type: String<br />Required: Yes | 
| **iconUrl** | The URL to the icon or logo for the AppClient.<br />Type: String<br />Required: No | 
| **redirectUrls** | The URI to redirect end users to after authorization. You can add up to 5 redirectUrls. For example, `https://localhost:8080`.<br />Type: Array of strings<br />Array Members: Minimum number of 1 item. Maximum number of 5 items.<br />Length Constraints: Minimum length of 1. Maximum length of 2048.<br />Pattern: `(http\|https):\/\/[-a-zA-Z0-9_:.\/]+`<br />Required: Yes | 
| **starterUserEmails** | Starter email addresses for users who are allowed access to receive insights until the AppClient is verified.<br />Type: Array of strings<br />Array Members: Fixed number of 1 item.<br />Length Constraints: Minimum length of 0. Maximum length of 320.<br />Pattern: `[a-zA-Z0-9.!#$%&’*+/=?^_`{\|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*`<br />Required: Yes | 
| **tags** | A map of the key-value pairs of the tag or tags to assign to the resource.<br />Type: Array of Tag objects<br />Array Members: Minimum number of 0 items. Maximum number of 50 items.<br />Required: No | 

## Response elements
<a name="API_CreateAppClient_response"></a>

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in JSON format by the service.


| Parameter | Description | 
| --- | --- | 
| **appClientSummary** | Contains a summary of the AppClient.<br />Type: [AppClientSummary](API_AppClientSummary.md) object |