Skip to main content

User File Management

If you're not using an HRIS integration, you can still manage your user list in sayhii using our file upload feature.

This gives you control over how users are added and updated—and ensures your employee data stays aligned with sayhii's structure.

Each upload uses a unique User Identifier to track changes:

  • If the User Identifier is new, a new user will be created.
  • If the User Identifier matches an existing user, their record will be updated with the new information.
note

After uploading a file, you'll see a confirmation message in the lower-left corner of the screen showing how many users were added or updated.

CSV Format

sayhii expects a properly formatted CSV file. You can wrap any value that includes commas in double quotes.

Below are the fields you can include in your file. Only two fields are required: the unique identifier and the user’s email address.

User AttributeAllowed CSV Column NamesRequiredNotes
User Identifierid, object_id, objectid, object_guid, objectguid✅ YesA unique ID used to match and update user records across uploads. This value should remain consistent.
User Emailemail, mail✅ YesThe user’s email address—used for registration and communication.
First Namefirst_name, firstname, given_name, givennameNoOptional. Used for personalization.
Last Namelast_name, lastname, surname, snNoOptional. Used for personalization.
Manager EmailmanagerNoOptional. Helps define reporting relationships.
DepartmentdepartmentNoOptional. Used for team-based analysis and insights.
Job Functionjob_title, jobtitle, job_function, jobfunctionNoOptional. Helps refine user segmentation.
Date of Birthdate_of_birth, dateofbirth, dobNoOptional. Only the year is used—taken from the first four characters.

Keeping your user data accurate and up to date helps ensure that sayhii can deliver insights that are both meaningful and actionable—whether you manage users through a file or an integrated system.