Hoxhunt offers you two ways to manage users through CSV Lists:
Option 1: User Import Tool in Hoxhunt Admin
Located in the Hoxhunt Admin Portal, the User Import tool can be used to import new users and to modify existing user data.
Using the User Import Tool
Navigate to Admin - Hoxhunt
Click + Add users.
The User Import tool includes two ways to import users to the Hoxhunt service:
Import few users - when you want to import a few users manually
CSV import - when you want to import a list of users with pre-defined details
Both options allow you to edit individual user details before the actual import starts.
Import via ‘Import few users’ option
1. Choose Import few users and click Start to initiate the user import.
2. Enter the emails addresses of the user/s you want to add to the Hoxhunt service and choose Review.
Email address domains must match one of the listed allowed domains for your organization. If you have errors related to this, please reach out to your Customer Success Manager or firstname.lastname@example.org for support in updating your allowed domains.
Type in the subsequent email addresses by separating them with a comma, space or return.
You can also paste in a list of email addresses with any of the following separators: comma, space or comma+space
3. In the Review and complete your import screen, check the user details. If you want to make any changes, click on the respective fields and edit the values.
4. Once you are satisfied with the user data, choose Import.
IMPORTANT: Please do not close the web page while the import is in progress! The import process is running on your local web client. If you close the window, the import will be interrupted.
5. When the import is finished, you can see a summary of the import results. Once you are satisfied with your import, choose Finish.
You can download a CSV for each batch of users for further review.
Import via ‘CSV Import’ option
1. Choose CSV Import and choose Start
2. Upload your CSV and choose Review
We highly recommend to download of your current user base via Data Inspector as a backup.
You can download our Option 1 - Hoxhunt User Import Template and insert your user data there for a smoother import experience.
Make sure to keep your CSV in UTF-8 encoding.
3. Next, review the user data and make necessary changes. Pay attention to fields highlighted in red as they contain errors. See Some user are highlighted in red on how to resolve invalid user data.
4. Once you are satisfied with the user data, click Start import.
NOTE: Importing user data to Hoxhunt may take a while.
IMPORTANT: Do not close the web page while import is in progress! The import process is running on your local web client. If you close the window, the import will be interrupted.
Once the import is complete, you can see how many users were created, how many users were updated and how many errors were still encountered during the import.
You can also download a CSV for each batch of users for further review.
5. Once you are satisfied with your import, choose Finish.
Questions about the User Import tool
What happens if user already exists?
If you are importing a user who is already in the Hoxhunt service, the user’s details will be updated based on your import data. The tool is not aware if a user already exists, but it can update their data if they exist.
Can we use this tool to add, update and delete users based on a master user list?
The User Import tool can be used to add new users and update existing users, but not to delete users. Deleting users or comparing importable CSV list to current user base is not yet available. You can still use the Admin Portal: User Management View to delete individual users or groups of users, read more here.
Some users are highlighted in red, what should I do?
User import tool detects if user data is not in accordance with import requirements. Most common errors are related to first name, last name and email address. Please fix the highlighted data and proceed.
NOTE: Due to security reasons, user's first name and last name cannot contain any bracket characters.
You can download a CSV of users who cause an error to resolve and process them later by selecting Download CSV > Errors only, selecting all visible users and then selecting Action > Delete.
NOTE: Deleted users are only excluded from the import process, not from your original CSV or Hoxhunt user base.
Import resulted in some errors, what should I do?
Download CSV of the users who resulted in an error, and double-check your user data is valid. Please then try to import the users again.
I can’t find the reason for my import errors, what should I do?
You network connection might have been interrupted, causing user import to end abruptly. If the error persists, please contact Hoxhunt support at email@example.com for assistance.
Option 2: Send your CSV to us
Adding users to Hoxhunt during the launch
If you have any trouble with the User Import Tool, you can also provide CSV lists to Hoxhunt Support periodically to keep your user base up-to-date.
Please provide a list of user details to your Hoxhunt representative using the attached Excel template.
IMPORTANT: Make sure the data you provide is correct! Up-to-date and correctly formatted country and department information is crucial for accurate reporting.
User list fields (See "Excel Userlist template" at bottom of page)
Optional fields for enriched reporting
NOTE: country is accepted in following ISO 3166-1 formats: English short name; two-letter code (Alpha-2)
Examples: FI, GB, ES, DE, SE
Optional fields for user experience
- language: user's preferred UI language
- questLanguages: user's preferred simulation language (NOTE: in addition to their preferred languages users will receive simulations also in English)
NOTE: language and questLanguages are accepted in following format: two-letter code (639-1)
Examples: fi, en, es, de, sv
INTENSIVE = user receives simulations + can report real threats
REPORT_ONLY = user can only report real threats and will not receive simulations from Hoxhunt
TRUE = user's name cannot be displayed on leaderboard or used in simulations sent to colleagues
FALSE = user's name will be displayed on leaderboard and can be used in simulations send to colleagues.
Updating the user list in Hoxhunt
Please provide a list of user details to Hoxhunt Support (firstname.lastname@example.org) using the attached Excel template. A complete user list is preferred for best result - Hoxhunt will take care of the comparison.