Rekognition / Client / create_user



Creates a new User within a collection specified by CollectionId. Takes UserId as a parameter, which is a user provided ID which should be unique within the collection. The provided UserId will alias the system generated UUID to make the UserId more user friendly.

Uses a ClientToken, an idempotency token that ensures a call to CreateUser completes only once. If the value is not supplied, the AWS SDK generates an idempotency token for the requests. This prevents retries after a network error results from making multiple CreateUser calls.

See also: AWS API Documentation

Request Syntax

response = client.create_user(
  • CollectionId (string) –


    The ID of an existing collection to which the new UserID needs to be created.

  • UserId (string) –


    ID for the UserID to be created. This ID needs to be unique within the collection.

  • ClientRequestToken (string) –

    Idempotent token used to identify the request to CreateUser. If you use the same token with multiple CreateUser requests, the same response is returned. Use ClientRequestToken to prevent the same request from being processed more than once.

    This field is autopopulated if not provided.

Return type:



Response Syntax


Response Structure

  • (dict) –


  • Rekognition.Client.exceptions.InvalidParameterException

  • Rekognition.Client.exceptions.ConflictException

  • Rekognition.Client.exceptions.ResourceNotFoundException

  • Rekognition.Client.exceptions.ServiceQuotaExceededException

  • Rekognition.Client.exceptions.ProvisionedThroughputExceededException

  • Rekognition.Client.exceptions.IdempotentParameterMismatchException

  • Rekognition.Client.exceptions.AccessDeniedException

  • Rekognition.Client.exceptions.InternalServerError

  • Rekognition.Client.exceptions.ThrottlingException