Import users in bulk

Use the Import Users feature to create or update multiple Axon Justice user accounts at once by uploading a CSV file.

When you upload a CSV file, Axon Justice matches records by EXTERNAL_ID:

  • New or missing external ID: Axon Justice creates a new user account if the email address, badge number, and username are each unique in your organization.
  • Matching external ID: Axon Justice updates the existing user account with the values in the CSV row.

Before you begin

Prepare a CSV file with the required information for each user. The file must include a header row and can contain up to 13 columns.

When you update existing users, if you omit an optional column, the import leaves that attribute unchanged. If you include an optional column but leave the value blank for a specific user, the import clears that attribute. For example, an empty RANK value removes the user's rank.

CSV column reference table

Header Value Required Value
EXTERNAL_ID Optional

A unique value that identifies the user, assigned by your organization. Valid external user IDs can be up to 255 characters. If left blank, Axon Justice auto-generates a unique external ID and creates a new user. If the external ID matches an existing user, that user's account is updated with the data in the CSV row. You can use the Export Results option on the All Users search page to export user information that includes the external ID.
EMAIL Required

The user's email address. Each user in your agency must have a unique email address.
BADGE_NUMBER Required

A unique badge ID that you assign. Typically, a user's badge number in Axon Justice should match the user's badge in other systems such as computer-aided dispatch (CAD) systems. This practice simplifies analysis and reporting of data aggregated from multiple systems.
FIRST_NAME Required

The user's first name.
LAST_NAME Required

The user's last name.
STATUS Required

Active — The user is able to register and sign in to Evidence.com immediately after you import the user account with the partner API.

Inactive — The user is not able to register or sign in to Evidence.com.
USERNAME Required

A unique username.
ROLE Required

The role assigned to the user. Valid values are the names of the roles configured in your Axon Justice organization.
SUPERVISOR_EMAIL Optional

The user's direct supervisor's email address, as used in Axon Justice.
LOCATION Optional

Reserved for future use.
RANK Optional

The rank assigned to the user. Valid values are the ranks configured in your Axon Justice organization.
EVIDENCE_GROUP_EXT_ID Optional

The external ID of the group assigned to the user. Must be an active group.
PHONE Optional

Phone number with leading country code.

Import users from a CSV file

  1. Select Admin.
  2. Under User Management, select Users.
  3. Select Import Users.
  4. Select Download Example File to download a template.
  5. Make a copy of the example file and give it a descriptive name.
  6. Open the file in a spreadsheet application.
  7. Delete rows 2 through 5 (the example data rows), keeping row 1 (the column header row).
  8. Enter the user information. Add one row per user you want to add or update.
  9. Save the file.
  10. Return to Axon Justice. Sign in again if your session has expired, then go to the Import Users page.
  11. Select Select File, choose your CSV file, then select Open.
  12. (Optional) To deactivate all currently active users who are not listed in the CSV file, select Deactivate all currently Active users not listed in the CSV file.
  13. Select Import.
  14. If you selected the deactivate option, a confirmation dialog appears. Enter "Confirm," then select Confirm to proceed.
  15. Axon Justice processes the file and displays a results summary showing which users were added, updated, or encountered errors.