1. Packages
  2. AWS Cloud Control
  3. API Docs
  4. connect
  5. getUser

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.57.0
published on Monday, Mar 9, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws-native

aws-native.connect.getUser

aws-native logo

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.57.0
published on Monday, Mar 9, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws-native

    Resource Type definition for AWS::Connect::User

    Using getUser

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getUser(args: GetUserArgs, opts?: InvokeOptions): Promise<GetUserResult>
function getUserOutput(args: GetUserOutputArgs, opts?: InvokeOptions): Output<GetUserResult>
    def get_user(user_arn: Optional[str] = None,
             opts: Optional[InvokeOptions] = None) -> GetUserResult
def get_user_output(user_arn: Optional[pulumi.Input[str]] = None,
             opts: Optional[InvokeOptions] = None) -> Output[GetUserResult]
    func LookupUser(ctx *Context, args *LookupUserArgs, opts ...InvokeOption) (*LookupUserResult, error)
func LookupUserOutput(ctx *Context, args *LookupUserOutputArgs, opts ...InvokeOption) LookupUserResultOutput

    > Note: This function is named LookupUser in the Go SDK.

    public static class GetUser 
{
    public static Task<GetUserResult> InvokeAsync(GetUserArgs args, InvokeOptions? opts = null)
    public static Output<GetUserResult> Invoke(GetUserInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetUserResult> getUser(GetUserArgs args, InvokeOptions options)
public static Output<GetUserResult> getUser(GetUserArgs args, InvokeOptions options)

    fn::invoke:
  function: aws-native:connect:getUser
  arguments:
    # arguments dictionary

    The following arguments are supported:

    UserArn string
    The Amazon Resource Name (ARN) for the user.
    UserArn string
    The Amazon Resource Name (ARN) for the user.
    userArn String
    The Amazon Resource Name (ARN) for the user.
    userArn string
    The Amazon Resource Name (ARN) for the user.
    user_arn str
    The Amazon Resource Name (ARN) for the user.
    userArn String
    The Amazon Resource Name (ARN) for the user.

    getUser Result

    The following output properties are available:

    AfterContactWorkConfigs List<Pulumi.AwsNative.Connect.Outputs.UserAfterContactWorkConfigPerChannel>
    After Contact Work configurations of a user.
    AutoAcceptConfigs List<Pulumi.AwsNative.Connect.Outputs.UserAutoAcceptConfig>
    Auto-accept configurations of a user.
    DirectoryUserId string
    The identifier of the user account in the directory used for identity management.
    HierarchyGroupArn string
    The identifier of the hierarchy group for the user.
    IdentityInfo Pulumi.AwsNative.Connect.Outputs.UserIdentityInfo
    The information about the identity of the user.
    InstanceArn string
    The identifier of the Amazon Connect instance.
    PersistentConnectionConfigs List<Pulumi.AwsNative.Connect.Outputs.UserPersistentConnectionConfig>
    Persistent Connection configurations of a user.
    PhoneConfig Pulumi.AwsNative.Connect.Outputs.UserPhoneConfig
    The phone settings for the user.
    PhoneNumberConfigs List<Pulumi.AwsNative.Connect.Outputs.UserPhoneNumberConfig>
    Phone Number configurations of a user.
    RoutingProfileArn string
    The identifier of the routing profile for the user.
    SecurityProfileArns List<string>
    One or more security profile arns for the user
    Tags List<Pulumi.AwsNative.Outputs.Tag>
    One or more tags.
    UserArn string
    The Amazon Resource Name (ARN) for the user.
    UserProficiencies List<Pulumi.AwsNative.Connect.Outputs.UserProficiency>
    One or more predefined attributes assigned to a user, with a level that indicates how skilled they are.
    Username string
    The user name for the account.
    VoiceEnhancementConfigs List<Pulumi.AwsNative.Connect.Outputs.UserVoiceEnhancementConfig>
    Voice Enhancement configurations of a user.
    AfterContactWorkConfigs []UserAfterContactWorkConfigPerChannel
    After Contact Work configurations of a user.
    AutoAcceptConfigs []UserAutoAcceptConfig
    Auto-accept configurations of a user.
    DirectoryUserId string
    The identifier of the user account in the directory used for identity management.
    HierarchyGroupArn string
    The identifier of the hierarchy group for the user.
    IdentityInfo UserIdentityInfo
    The information about the identity of the user.
    InstanceArn string
    The identifier of the Amazon Connect instance.
    PersistentConnectionConfigs []UserPersistentConnectionConfig
    Persistent Connection configurations of a user.
    PhoneConfig UserPhoneConfig
    The phone settings for the user.
    PhoneNumberConfigs []UserPhoneNumberConfig
    Phone Number configurations of a user.
    RoutingProfileArn string
    The identifier of the routing profile for the user.
    SecurityProfileArns []string
    One or more security profile arns for the user
    Tags Tag
    One or more tags.
    UserArn string
    The Amazon Resource Name (ARN) for the user.
    UserProficiencies []UserProficiency
    One or more predefined attributes assigned to a user, with a level that indicates how skilled they are.
    Username string
    The user name for the account.
    VoiceEnhancementConfigs []UserVoiceEnhancementConfig
    Voice Enhancement configurations of a user.
    afterContactWorkConfigs List<UserAfterContactWorkConfigPerChannel>
    After Contact Work configurations of a user.
    autoAcceptConfigs List<UserAutoAcceptConfig>
    Auto-accept configurations of a user.
    directoryUserId String
    The identifier of the user account in the directory used for identity management.
    hierarchyGroupArn String
    The identifier of the hierarchy group for the user.
    identityInfo UserIdentityInfo
    The information about the identity of the user.
    instanceArn String
    The identifier of the Amazon Connect instance.
    persistentConnectionConfigs List<UserPersistentConnectionConfig>
    Persistent Connection configurations of a user.
    phoneConfig UserPhoneConfig
    The phone settings for the user.
    phoneNumberConfigs List<UserPhoneNumberConfig>
    Phone Number configurations of a user.
    routingProfileArn String
    The identifier of the routing profile for the user.
    securityProfileArns List<String>
    One or more security profile arns for the user
    tags List<Tag>
    One or more tags.
    userArn String
    The Amazon Resource Name (ARN) for the user.
    userProficiencies List<UserProficiency>
    One or more predefined attributes assigned to a user, with a level that indicates how skilled they are.
    username String
    The user name for the account.
    voiceEnhancementConfigs List<UserVoiceEnhancementConfig>
    Voice Enhancement configurations of a user.
    afterContactWorkConfigs UserAfterContactWorkConfigPerChannel[]
    After Contact Work configurations of a user.
    autoAcceptConfigs UserAutoAcceptConfig[]
    Auto-accept configurations of a user.
    directoryUserId string
    The identifier of the user account in the directory used for identity management.
    hierarchyGroupArn string
    The identifier of the hierarchy group for the user.
    identityInfo UserIdentityInfo
    The information about the identity of the user.
    instanceArn string
    The identifier of the Amazon Connect instance.
    persistentConnectionConfigs UserPersistentConnectionConfig[]
    Persistent Connection configurations of a user.
    phoneConfig UserPhoneConfig
    The phone settings for the user.
    phoneNumberConfigs UserPhoneNumberConfig[]
    Phone Number configurations of a user.
    routingProfileArn string
    The identifier of the routing profile for the user.
    securityProfileArns string[]
    One or more security profile arns for the user
    tags Tag[]
    One or more tags.
    userArn string
    The Amazon Resource Name (ARN) for the user.
    userProficiencies UserProficiency[]
    One or more predefined attributes assigned to a user, with a level that indicates how skilled they are.
    username string
    The user name for the account.
    voiceEnhancementConfigs UserVoiceEnhancementConfig[]
    Voice Enhancement configurations of a user.
    after_contact_work_configs Sequence[UserAfterContactWorkConfigPerChannel]
    After Contact Work configurations of a user.
    auto_accept_configs Sequence[UserAutoAcceptConfig]
    Auto-accept configurations of a user.
    directory_user_id str
    The identifier of the user account in the directory used for identity management.
    hierarchy_group_arn str
    The identifier of the hierarchy group for the user.
    identity_info UserIdentityInfo
    The information about the identity of the user.
    instance_arn str
    The identifier of the Amazon Connect instance.
    persistent_connection_configs Sequence[UserPersistentConnectionConfig]
    Persistent Connection configurations of a user.
    phone_config UserPhoneConfig
    The phone settings for the user.
    phone_number_configs Sequence[UserPhoneNumberConfig]
    Phone Number configurations of a user.
    routing_profile_arn str
    The identifier of the routing profile for the user.
    security_profile_arns Sequence[str]
    One or more security profile arns for the user
    tags Sequence[root_Tag]
    One or more tags.
    user_arn str
    The Amazon Resource Name (ARN) for the user.
    user_proficiencies Sequence[UserProficiency]
    One or more predefined attributes assigned to a user, with a level that indicates how skilled they are.
    username str
    The user name for the account.
    voice_enhancement_configs Sequence[UserVoiceEnhancementConfig]
    Voice Enhancement configurations of a user.
    afterContactWorkConfigs List<Property Map>
    After Contact Work configurations of a user.
    autoAcceptConfigs List<Property Map>
    Auto-accept configurations of a user.
    directoryUserId String
    The identifier of the user account in the directory used for identity management.
    hierarchyGroupArn String
    The identifier of the hierarchy group for the user.
    identityInfo Property Map
    The information about the identity of the user.
    instanceArn String
    The identifier of the Amazon Connect instance.
    persistentConnectionConfigs List<Property Map>
    Persistent Connection configurations of a user.
    phoneConfig Property Map
    The phone settings for the user.
    phoneNumberConfigs List<Property Map>
    Phone Number configurations of a user.
    routingProfileArn String
    The identifier of the routing profile for the user.
    securityProfileArns List<String>
    One or more security profile arns for the user
    tags List<Property Map>
    One or more tags.
    userArn String
    The Amazon Resource Name (ARN) for the user.
    userProficiencies List<Property Map>
    One or more predefined attributes assigned to a user, with a level that indicates how skilled they are.
    username String
    The user name for the account.
    voiceEnhancementConfigs List<Property Map>
    Voice Enhancement configurations of a user.

    Supporting Types

    Tag

    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    UserAfterContactWorkConfig

    UserAfterContactWorkConfigPerChannel

    UserAutoAcceptConfig

    UserChannel

    UserIdentityInfo

    Email string
    The email address. If you are using SAML for identity management and include this parameter, an error is returned.
    FirstName string
    The first name. This is required if you are using Amazon Connect or SAML for identity management. Inputs must be in Unicode Normalization Form C (NFC). Text containing characters in a non-NFC form (for example, decomposed characters or combining marks) are not accepted.
    LastName string
    The last name. This is required if you are using Amazon Connect or SAML for identity management. Inputs must be in Unicode Normalization Form C (NFC). Text containing characters in a non-NFC form (for example, decomposed characters or combining marks) are not accepted.
    Mobile string
    The user's mobile number.
    SecondaryEmail string

    The user's secondary email address. If you provide a secondary email, the user receives email notifications -- other than password reset notifications -- to this email address instead of to their primary email address.

    Pattern : (?=^.{0,265}$)[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,63}

    Email string
    The email address. If you are using SAML for identity management and include this parameter, an error is returned.
    FirstName string
    The first name. This is required if you are using Amazon Connect or SAML for identity management. Inputs must be in Unicode Normalization Form C (NFC). Text containing characters in a non-NFC form (for example, decomposed characters or combining marks) are not accepted.
    LastName string
    The last name. This is required if you are using Amazon Connect or SAML for identity management. Inputs must be in Unicode Normalization Form C (NFC). Text containing characters in a non-NFC form (for example, decomposed characters or combining marks) are not accepted.
    Mobile string
    The user's mobile number.
    SecondaryEmail string

    The user's secondary email address. If you provide a secondary email, the user receives email notifications -- other than password reset notifications -- to this email address instead of to their primary email address.

    Pattern : (?=^.{0,265}$)[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,63}

    email String
    The email address. If you are using SAML for identity management and include this parameter, an error is returned.
    firstName String
    The first name. This is required if you are using Amazon Connect or SAML for identity management. Inputs must be in Unicode Normalization Form C (NFC). Text containing characters in a non-NFC form (for example, decomposed characters or combining marks) are not accepted.
    lastName String
    The last name. This is required if you are using Amazon Connect or SAML for identity management. Inputs must be in Unicode Normalization Form C (NFC). Text containing characters in a non-NFC form (for example, decomposed characters or combining marks) are not accepted.
    mobile String
    The user's mobile number.
    secondaryEmail String

    The user's secondary email address. If you provide a secondary email, the user receives email notifications -- other than password reset notifications -- to this email address instead of to their primary email address.

    Pattern : (?=^.{0,265}$)[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,63}

    email string
    The email address. If you are using SAML for identity management and include this parameter, an error is returned.
    firstName string
    The first name. This is required if you are using Amazon Connect or SAML for identity management. Inputs must be in Unicode Normalization Form C (NFC). Text containing characters in a non-NFC form (for example, decomposed characters or combining marks) are not accepted.
    lastName string
    The last name. This is required if you are using Amazon Connect or SAML for identity management. Inputs must be in Unicode Normalization Form C (NFC). Text containing characters in a non-NFC form (for example, decomposed characters or combining marks) are not accepted.
    mobile string
    The user's mobile number.
    secondaryEmail string

    The user's secondary email address. If you provide a secondary email, the user receives email notifications -- other than password reset notifications -- to this email address instead of to their primary email address.

    Pattern : (?=^.{0,265}$)[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,63}

    email str
    The email address. If you are using SAML for identity management and include this parameter, an error is returned.
    first_name str
    The first name. This is required if you are using Amazon Connect or SAML for identity management. Inputs must be in Unicode Normalization Form C (NFC). Text containing characters in a non-NFC form (for example, decomposed characters or combining marks) are not accepted.
    last_name str
    The last name. This is required if you are using Amazon Connect or SAML for identity management. Inputs must be in Unicode Normalization Form C (NFC). Text containing characters in a non-NFC form (for example, decomposed characters or combining marks) are not accepted.
    mobile str
    The user's mobile number.
    secondary_email str

    The user's secondary email address. If you provide a secondary email, the user receives email notifications -- other than password reset notifications -- to this email address instead of to their primary email address.

    Pattern : (?=^.{0,265}$)[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,63}

    email String
    The email address. If you are using SAML for identity management and include this parameter, an error is returned.
    firstName String
    The first name. This is required if you are using Amazon Connect or SAML for identity management. Inputs must be in Unicode Normalization Form C (NFC). Text containing characters in a non-NFC form (for example, decomposed characters or combining marks) are not accepted.
    lastName String
    The last name. This is required if you are using Amazon Connect or SAML for identity management. Inputs must be in Unicode Normalization Form C (NFC). Text containing characters in a non-NFC form (for example, decomposed characters or combining marks) are not accepted.
    mobile String
    The user's mobile number.
    secondaryEmail String

    The user's secondary email address. If you provide a secondary email, the user receives email notifications -- other than password reset notifications -- to this email address instead of to their primary email address.

    Pattern : (?=^.{0,265}$)[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,63}

    UserPersistentConnectionConfig

    UserPhoneConfig

    AfterContactWorkTimeLimit int

    The After Call Work (ACW) timeout setting, in seconds. This parameter has a minimum value of 0 and a maximum value of 2,000,000 seconds (24 days). Enter 0 if you don't want to allocate a specific amount of ACW time. It essentially means an indefinite amount of time. When the conversation ends, ACW starts; the agent must choose Close contact to end ACW.

    When returned by a SearchUsers call, AfterContactWorkTimeLimit is returned in milliseconds.

    AutoAccept bool
    The Auto accept setting.
    DeskPhoneNumber string
    The phone number for the user's desk phone.
    PersistentConnection bool
    The persistent connection setting for the user.
    PhoneType Pulumi.AwsNative.Connect.UserPhoneType
    The phone type.
    AfterContactWorkTimeLimit int

    The After Call Work (ACW) timeout setting, in seconds. This parameter has a minimum value of 0 and a maximum value of 2,000,000 seconds (24 days). Enter 0 if you don't want to allocate a specific amount of ACW time. It essentially means an indefinite amount of time. When the conversation ends, ACW starts; the agent must choose Close contact to end ACW.

    When returned by a SearchUsers call, AfterContactWorkTimeLimit is returned in milliseconds.

    AutoAccept bool
    The Auto accept setting.
    DeskPhoneNumber string
    The phone number for the user's desk phone.
    PersistentConnection bool
    The persistent connection setting for the user.
    PhoneType UserPhoneType
    The phone type.
    afterContactWorkTimeLimit Integer

    The After Call Work (ACW) timeout setting, in seconds. This parameter has a minimum value of 0 and a maximum value of 2,000,000 seconds (24 days). Enter 0 if you don't want to allocate a specific amount of ACW time. It essentially means an indefinite amount of time. When the conversation ends, ACW starts; the agent must choose Close contact to end ACW.

    When returned by a SearchUsers call, AfterContactWorkTimeLimit is returned in milliseconds.

    autoAccept Boolean
    The Auto accept setting.
    deskPhoneNumber String
    The phone number for the user's desk phone.
    persistentConnection Boolean
    The persistent connection setting for the user.
    phoneType UserPhoneType
    The phone type.
    afterContactWorkTimeLimit number

    The After Call Work (ACW) timeout setting, in seconds. This parameter has a minimum value of 0 and a maximum value of 2,000,000 seconds (24 days). Enter 0 if you don't want to allocate a specific amount of ACW time. It essentially means an indefinite amount of time. When the conversation ends, ACW starts; the agent must choose Close contact to end ACW.

    When returned by a SearchUsers call, AfterContactWorkTimeLimit is returned in milliseconds.

    autoAccept boolean
    The Auto accept setting.
    deskPhoneNumber string
    The phone number for the user's desk phone.
    persistentConnection boolean
    The persistent connection setting for the user.
    phoneType UserPhoneType
    The phone type.
    after_contact_work_time_limit int

    The After Call Work (ACW) timeout setting, in seconds. This parameter has a minimum value of 0 and a maximum value of 2,000,000 seconds (24 days). Enter 0 if you don't want to allocate a specific amount of ACW time. It essentially means an indefinite amount of time. When the conversation ends, ACW starts; the agent must choose Close contact to end ACW.

    When returned by a SearchUsers call, AfterContactWorkTimeLimit is returned in milliseconds.

    auto_accept bool
    The Auto accept setting.
    desk_phone_number str
    The phone number for the user's desk phone.
    persistent_connection bool
    The persistent connection setting for the user.
    phone_type UserPhoneType
    The phone type.
    afterContactWorkTimeLimit Number

    The After Call Work (ACW) timeout setting, in seconds. This parameter has a minimum value of 0 and a maximum value of 2,000,000 seconds (24 days). Enter 0 if you don't want to allocate a specific amount of ACW time. It essentially means an indefinite amount of time. When the conversation ends, ACW starts; the agent must choose Close contact to end ACW.

    When returned by a SearchUsers call, AfterContactWorkTimeLimit is returned in milliseconds.

    autoAccept Boolean
    The Auto accept setting.
    deskPhoneNumber String
    The phone number for the user's desk phone.
    persistentConnection Boolean
    The persistent connection setting for the user.
    phoneType "SOFT_PHONE" | "DESK_PHONE"
    The phone type.

    UserPhoneNumberConfig

    UserPhoneType

    UserProficiency

    AttributeName string
    The name of user’s proficiency. You must use a predefined attribute name that is present in the Amazon Connect instance.
    AttributeValue string
    The value of user’s proficiency. You must use a predefined attribute value that is present in the Amazon Connect instance.
    Level double
    The level of the proficiency. The valid values are 1, 2, 3, 4 and 5.
    AttributeName string
    The name of user’s proficiency. You must use a predefined attribute name that is present in the Amazon Connect instance.
    AttributeValue string
    The value of user’s proficiency. You must use a predefined attribute value that is present in the Amazon Connect instance.
    Level float64
    The level of the proficiency. The valid values are 1, 2, 3, 4 and 5.
    attributeName String
    The name of user’s proficiency. You must use a predefined attribute name that is present in the Amazon Connect instance.
    attributeValue String
    The value of user’s proficiency. You must use a predefined attribute value that is present in the Amazon Connect instance.
    level Double
    The level of the proficiency. The valid values are 1, 2, 3, 4 and 5.
    attributeName string
    The name of user’s proficiency. You must use a predefined attribute name that is present in the Amazon Connect instance.
    attributeValue string
    The value of user’s proficiency. You must use a predefined attribute value that is present in the Amazon Connect instance.
    level number
    The level of the proficiency. The valid values are 1, 2, 3, 4 and 5.
    attribute_name str
    The name of user’s proficiency. You must use a predefined attribute name that is present in the Amazon Connect instance.
    attribute_value str
    The value of user’s proficiency. You must use a predefined attribute value that is present in the Amazon Connect instance.
    level float
    The level of the proficiency. The valid values are 1, 2, 3, 4 and 5.
    attributeName String
    The name of user’s proficiency. You must use a predefined attribute name that is present in the Amazon Connect instance.
    attributeValue String
    The value of user’s proficiency. You must use a predefined attribute value that is present in the Amazon Connect instance.
    level Number
    The level of the proficiency. The valid values are 1, 2, 3, 4 and 5.

    UserVoiceEnhancementConfig

    UserVoiceEnhancementMode

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.57.0
    published on Monday, Mar 9, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-aws-native
      Try Pulumi Cloud free. Your team will thank you.