Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

    English (US)
    MX Spanish (Mexico)
    CA French (Canada)
    US English (US)
    • Home
    • Management Tools
    • Data Feeds
    • Employee/User Feeds

    Employee/user file requirements

    Written by Lindsey Stanifer

    Updated at August 20th, 2026

    Contact Us

    If you still have questions or prefer to get help directly from an agent, please submit a request.
    We’ll get back to you as soon as possible.

    Please fill out the contact form below and we will reply as soon as possible.

    • Getting Started
      Setting up your calendar Managing your alerts Additional Settings
    • Daily Processes
      Candidate Inbox Candidate Profile My Calendar/Calendars Browser Extension My Jobs Approvals Engine Manual and Common Scheduling Practices Form I-9 processes Troubleshooting Forms & Offers
    • Candidate and User Engagement
      Campaigns Conversation Builder Surveys Channels Talent Community Voice Web Management Analytics & Reporting Data Privacy Career Sites
    • Management Tools
      Job Management Scheduling Security Journeys Content Management System (CMS) Multiple Brands Workflows Users, Roles and Permissions Data Feeds Location Management Lookup Tables Assistant Messaging Company Information Client Setup System Attributes Integration Center
    • Contextual AI
      Knowledge Training Library
    • Conversational Events and Campus
      Conversational Events Campus Events
    • Employee Communications
      Communications App Employee Management
    • Release Notes
      2025 2026
    • Workday Feature Descriptions
    + More

    Table of Contents

    Timestamp formats accepted

    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

    • Use format on TZ database name column of this wiki: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones ​
    • If Timezone is blank and the account has a set default timezone > Get default timezone.
    • If Timezone isn’t blank > Get timezone in the file.

    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: 

    • Update
    • Reactivate
    • Add
    • Delete/Deactivate/Inactive
    • MODIFY
    • Add/Update: Add new or update users
    • Reactivate/Add/Update: Reactivate inactive users
    • Delete/Deactivate/Inactive: Deactivate users
    • MODIFY(Location, Area, RR):
      • Blank > No assign/remove assign
      • Valid data > Assign
      • New data > Overwrite assign old data

    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)
    conversational ats integrated ats

    Was this article helpful?

    Yes
    No
    Give feedback about this article

    Related Articles

    • Create an employee (user) form
    • Employee Feeds (User uploads) overview
    • Employee Attributes

    Copyright 2026 – Paradox.

    Knowledge Base Software powered by Helpjuice

    Expand