Table Of Contents


User Guide

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

[ aws . cognito-idp ]



Confirms registration of a user and handles the existing alias from a previous user.

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.


--client-id <value>
[--secret-hash <value>]
--username <value>
--confirmation-code <value>
[--force-alias-creation | --no-force-alias-creation]
[--analytics-metadata <value>]
[--user-context-data <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]


--client-id (string)

The ID of the app client associated with the user pool.

--secret-hash (string)

A keyed-hash message authentication code (HMAC) calculated using the secret key of a user pool client and username plus the client ID in the message.

--username (string)

The user name of the user whose registration you wish to confirm.

--confirmation-code (string)

The confirmation code sent by a user's request to confirm registration.

--force-alias-creation | --no-force-alias-creation (boolean)

Boolean to be specified to force user confirmation irrespective of existing alias. By default set to False . If this parameter is set to True and the phone number/email used for sign up confirmation already exists as an alias with a different user, the API call will migrate the alias from the previous user to the newly created user being confirmed. If set to False , the API will throw an AliasExistsException error.

--analytics-metadata (structure)

The Amazon Pinpoint analytics metadata for collecting metrics for confirm-sign-up calls.

Shorthand Syntax:


JSON Syntax:

  "AnalyticsEndpointId": "string"

--user-context-data (structure)

Contextual data such as the user's device fingerprint, IP address, or location used for evaluating the risk of an unexpected event by Amazon Cognito advanced security.

Shorthand Syntax:


JSON Syntax:

  "EncodedData": "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.

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