Add users to Amazon Connect
You can add users and configure them with permissions that are appropriate to their roles (for example, agents or managers). For more information, see Security profiles. Contacts can be routed based on the skills required of the agents. For more information, see Create a routing profile.
This topic explains how to add users using the Amazon Connect admin website. To add users programmatically, see CreateUser in the Amazon Connect API Reference Guide. To use the CLI, see create-user.
Required permissions for adding users
Before you can add users to Amazon Connect, you need the following permissions assigned to your security profile: Users - Create. The following image shows that this security profile permission is in the Users and permissions section of the Add/Edit security profile page.

By default, the Amazon Connect Admin security profile has these permissions.
For information about how add more permissions to an existing security profile, see Update security profiles.
Add a user individually
-
Log in to Amazon Connect at https://
instance name
.my.connect.aws/. Use an Admin account, or an account assigned to a security profile that has permissions to create users. -
In Amazon Connect, on the left navigation menu, choose Users, User management.
-
Choose Add new users.
-
Choose Create and set up a new user and then choose Next.
-
Enter the name, email address, secondary email address, mobile number, and password for the user.
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.
Tip
Mobile number is not currently used by Amazon Connect.
-
Choose a routing profile and a security profile.
-
Optionally, add resource tags to identify, organize, search for, filter, and control who can access this user.
-
Choose Save. If the Save button isn't active, it means you're logged in with an Amazon Connect account that doesn't have the required security profile permissions.
To fix this issue, log in with an account that is assigned to the Amazon Connect Admin security profile. Or, ask another Admin to help.
-
For information about adding agents, see Configure agent settings: routing profile, phone type, and auto-accept calls.
Add users in bulk from a .csv file
Note
Avoid adding too many unique resources in the .csv file. For example, don't add more than 100 different routing profiles. This may cause a timeout or failure during the validation process.
Bulk upload is for adding new records, not for editing existing records. To edit user records in bulk, see Edit users in bulk.
Use these steps to add several users from a .csv file such as an Excel spreadsheet.
-
Log in to Amazon Connect with an Admin account, or an account assigned to a security profile that has permissions to create users.
-
In Amazon Connect, on the left navigation menu, choose Users, User management.
-
Choose Add new users.
-
Choose Upload my users from a template (.csv) and then choose Next.
The .csv template has the following columns in the first row:
-
first name
-
last name
-
email address
-
secondary email address
-
mobile: This is not currently used by Amazon Connect.
-
password
-
user login
-
agent hierarchy
-
routing profile name
-
security_profile_name_1|security_profile_name_2
-
user_hierarchy_1|user_hierarchy_2
-
phone type (soft/desk)
-
phone number
-
soft phone auto accept yes/no)
-
ACW timeout (seconds)
-
tags
The following image shows a sample of what the .csv template looks like in an Excel spreadsheet. The first row in the spreadsheet contains the column headings, and the second row contains sample user data.
-
-
Choose Download template.
-
Add your users to the template and upload it to Amazon Connect.
If you get an error message, it usually indicates that one of the required columns is missing information, or there's a typo in one of the cells.
-
We recommend checking the format of the phone number as a starting point in your investigation.
-
If you get an error message that Security profile is not found, check whether there's a typo in one of the cells in the security_profile_name_1 column.
-
Check that passwords meet requirements: at least 8 characters with an uppercase letter, lowercase letter, and number. For example, if there's an ellipsis (...) in a password, this can cause an error.
-
Update the .csv file and try uploading it again.
The following image shows an example error message that you might get when uploading your csv file. It indicates the routing profile is not valid.
