Table Of Contents

Feedback

User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . connect ]

create-user

Description

Creates a user account for the specified Amazon Connect instance.

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.

Synopsis

  create-user
--username <value>
[--password <value>]
[--identity-info <value>]
--phone-config <value>
[--directory-user-id <value>]
--security-profile-ids <value>
--routing-profile-id <value>
[--hierarchy-group-id <value>]
--instance-id <value>
[--tags <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]

Options

--username (string)

The user name for the account. For instances not using SAML for identity management, the user name can include up to 20 characters. If you are using SAML for identity management, the user name can include up to 64 characters from [a-zA-Z0-9_-.@]+.

--password (string)

The password for the user account. A password is required if you are using Amazon Connect for identity management. Otherwise, it is an error to include a password.

--identity-info (structure)

The information about the identity of the user.

Shorthand Syntax:

FirstName=string,LastName=string,Email=string

JSON Syntax:

{
  "FirstName": "string",
  "LastName": "string",
  "Email": "string"
}

--phone-config (structure)

The phone settings for the user.

Shorthand Syntax:

PhoneType=string,AutoAccept=boolean,AfterContactWorkTimeLimit=integer,DeskPhoneNumber=string

JSON Syntax:

{
  "PhoneType": "SOFT_PHONE"|"DESK_PHONE",
  "AutoAccept": true|false,
  "AfterContactWorkTimeLimit": integer,
  "DeskPhoneNumber": "string"
}

--directory-user-id (string)

The identifier of the user account in the directory used for identity management. If Amazon Connect cannot access the directory, you can specify this identifier to authenticate users. If you include the identifier, we assume that Amazon Connect cannot access the directory. Otherwise, the identity information is used to authenticate users from your directory.

This parameter is required if you are using an existing directory for identity management in Amazon Connect when Amazon Connect cannot access your directory to authenticate users. If you are using SAML for identity management and include this parameter, an error is returned.

--security-profile-ids (list)

The identifier of the security profile for the user.

Syntax:

"string" "string" ...

--routing-profile-id (string)

The identifier of the routing profile for the user.

--hierarchy-group-id (string)

The identifier of the hierarchy group for the user.

--instance-id (string)

The identifier of the Amazon Connect instance.

--tags (map)

One or more tags.

Shorthand Syntax:

KeyName1=string,KeyName2=string

JSON Syntax:

{"string": "string"
  ...}

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See 'aws help' for descriptions of global parameters.

Output

UserId -> (string)

The identifier of the user account.

UserArn -> (string)

The Amazon Resource Name (ARN) of the user account.