Table of Contents
Below are the following accepted/required fields for user files. For any questions on custom fields, please reach out to your CS Representative.
| Field | Required | Format | Description | Note |
|---|---|---|---|---|
| Name | ✅ | String | User’s name | If first and last names are split, we will read columns left to right. Name can be mapped twice. |
| Employee ID | String | A unique ID associated with a particular user (could be employee ID, etc.) | ||
| Job Title | ✅ | String | User’s job title | |
| Email Address | ✅ | String | User’s email. Used for calendar integrations/communication | Required unless the login method is set to phone number. |
| Phone | ✅ see note | Integer | User’s phone number | Required if login method is set to phone number. |
| Location ID |
String or Array of Strings |
ID of the location, which will also mirror “location_ID” within the Location feed for location: user assignment OR “ALL” to give the user access to all locations in the account |
Locations for existing users will only be added if the user is mapped to an action of add or update. (No locations will get removed). To add locations to a user while also removing their current location permissions, they need to be mapped to the action of Modify. |
|
| Country | String | User’s country. Used to determine busy time/holiday calendars if configured | Must be ISO 2 or 3 format https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes | |
| User Role | ✅ | String | Paradox permission level that this user should be assigned to | |
| Timezone | String |
User’s timezone
|
Note: This only applies when adding a new user and does not apply to updating a user. |
|
| Action | String |
What should be done with this user? Options include:
|
If the action is not Delete, Deactivate, Inactive, MODIFY, or not mapped, then the file will import as ADD/Update. |
|
| Job Code |
String or Array of Strings |
Job code of the job, which will also mirror the Job code within the Job Feed for jobs: user hiring | ||
| Area Name |
String or Array of Strings |
This mirrors Area name”within the Location Feed for area: user assignment |
Areas for existing users will only be added if the user is mapped to an action of add or update. (No Areas will get removed). To add areas to a user while also removing their current areas permissions, they need to be mapped to the action of Modify. |
|
| Round Robin Group ID |
String or Array of Strings |
Round Robin Manager for Round Robin Group: user assignment | ||
| Languages Preference | String | Assigning a different language to a user | ||
| Workday Integration ID | String | Assigning a user to a Workday Integration |
Timestamp formats accepted
The following timestamp formats are accepted through user feeds:
- MM-DD-YYYY (04-03-2025)
- DD-MM-YYYY (03-04-2025)
- YYYY-MM-DD (2025-04-03)
- MMDDYYYY (04032025)
- DDMMYYYY (03042025)
- YYYYMMDD (20250403)
- MMDDYYYYHHmmss (04032025084608)
- DDMMYYYYHHmmss (03042025084608)
- YYYYMMDDHHmmss (20250403084608)
- MMDDYYYY_HHmmss (04032025_084608)
- DDMMYYYY_HHmmss (03042025_084608)
- YYYYMMDD_HHmmss (20250403_084608)
- MMDDYY_HHmmss (040325_084608)
- DDMMYY_HHmmss (030425_084608)
- YYMMDD_HHmmss (250403_084608)
- MMDDYYHHmmss (040325084608)
- DDMMYYHHmmss (030425084608)
- YYMMDDHHmmss (250403084608)