How Do I Add or Update Users with a CSV Upload?
Last updated: November 12, 2026
A CSV upload creates new users and updates existing ones in a single pass, which makes it the best choice for onboarding a whole team or making bulk changes. Email is how Ambition matches each row to a user, so every row needs one.
Required permissions:
The Users: Create permission is required to upload users.
Upload the CSV File
Go to Admin --> People --> Users and click on Create New User.
Select Upload Users from the Choose Creation Method drop-down menu.
Click on Upload CSV and choose your file. The first row must hold the column names. A preview of the first rows will appear.
Map the Columns
For each row under CSV Fields, select the matching Ambition attribute from the Select attribute... drop-down menu in the User Fields column.
Uncheck the Import box for any column you don't want to bring in.
Leave Use email as username checked unless your usernames differ from emails, as with Salesforce usernames.
Click on Continue.
Review and Upload
Review the new users and changes to existing users in the Confirm & Upload step.
Optional: Check Send Invite Email(s) to invite the new users right away.
Click on Upload Users, then click on Upload Users again in the Confirm Upload pop-up.
Note:
Group names in your file must match existing Groups exactly. If a Group is missing, you'll be asked whether to create it or ignore it during the upload.