Help Center Home > Users > Import Custom User Attributes from CSV

Import Custom User Attributes from CSV

Within JumpCloud you can configure custom user attributes, see Custom User Attributes to learn more. This article is intended to provide IT Admins a method of modifying these attributes using the JumpCloud API.

JumpCloud provides a pre-compiled binary within our API Utility rollup. Download the latest rollup on GitHub. The uncompressed package will contain the file ImportUserAttributes_os_arch.

ImportUserAttributes Usage

Linux / Mac OS X:

./ImportUserAttributes_darwin_amd64

Usage of ./ImportUserAttributes: -api-key="": -api-key= -input="": -input= -output="": -output=
-url="": -url=https://console.jumpcloud.com/api

./ImportUserAttributes_darwin_amd64 -api-key="YOUR_API_KEY" -input="PATH_TO_CSV" -output="PATH_TO_OUTPUT_LOG" -url="https://console.jumpcloud.com/api"

Windows:

PS C:\Users\Administrator\Downloads> .\ImportUserAttributes.exe Usage of ./ImportUserAttributes: -api-key="": -api-key= -input="": -input= -output="": -output= -url="": -url=https://console.jumpcloud.com/api

PS C:\Users\Administrator\Downloads> .\ImportUserAttributes_darwin_amd64 -api-key="YOUR_API_KEY" -input="PATH_TO_CSV" -output="PATH_TO_OUTPUT_LOG" -url="https://console.jumpcloud.com/api"

Building the CSV File

The first row will need to apply the following format for the first two columns headers:

email: Users are identified from the CSV based on the email address input, and should match that of the email address of the JumpCloud User.
[insert custom attribute name here]: This entry represents the Attribute Name that you would like to assign the users. See Custom User Attributes or more information on the Name attribute.

From the second row onward, the entries are values for either email or the custom attribute name specified. In the below example, the users are given a custom attribute name of Manager. The inputs denote the user's manager's name.