Upload Users in a .CSV File

Upload users in a .csv file.

Requirements: Any paid subscription

Also see:

Upload Locations in a .CSV File

Upload Categories in a .CSV File

If you need to add and invite multiple users at one time, it may be easier to upload the users instead of setting them up one at a time manually.  As with locations and categories, users can be uploaded in their own .csv file. When a .csv file is uploaded, all users are automatically emailed an invitation to create an account.

Add Users via .CSV File using the Import Template

1. Download the user import template 

Download the template from your account via Users > Import. Click on the Download link to download the import template:

Once you obtain the Bullseye User Import Template, you’ll have the correct file type to upload (.csv) with the correct column structure. The Bullseye User Import Template requires specific values for column headers.  If column headers do not match, the entire column will be ignored.  If the column headers are spelled incorrectly, you will receive an errors when you upload. All columns are required.

2. Enter your user data into the downloaded Bullseye User Import Template .csv

Assuming you have your users in a database or spreadsheet, you can copy and paste the data from your internal file into our file, on a column to column basis.  For instance, you may have a column called “First Name” or something similar which contains the first name of all your users. Data from this column  would go into the “FirstName” column on the downloaded template.

3. Check the data for formatting

Certain data elements require specific formatting. For instance, Username must be a valid email address.  Look through your database and identify and fix and data that is not formatted appropriately.  Once you are done entering the data, save the file. See detailed format instructions at the end of this document.

4. Upload the data

To upload the data, go to Upload File, and browse to the file, then click the Import Users button. Bullseye will attempt to import.

5. Fix Upload Errors 

Often there will be some issues with the data even if you check for errors before you import.  The larger the data file, the more likely this becomes.  After you upload the file, you may get error messages. 

 To view specifics on the error, select Details on the right. You'll see more details on the error so you can address the issues:

You will see a screen that looks similar to above, though your errors may vary. 

Format Instructions for your .csv file

Column Name

Required

Data Type (acceptable values/example)

Notes

SAMLEnabled

Yes

“Yes”, “No”


Username

Yes

A valid email address

Must be a unique value

FirstName

Yes

String


LastName

Yes


Role

Yes

String

Must be a valid role

LocationIDs No Number Either LocationIDs or LocationThirdPartyIDs is required for location assignment. Multiple semicolon-separated values are accepted.
LocationThirdPartyIDs No Either LocationIDs or LocationThirdPartyIDs is required for location assignment Multiple semicolon-separated values are accepted.