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.
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 Attribute | Allowed CSV Column Names | Required | Notes |
|---|---|---|---|
| User Identifier | id, object_id, objectid, object_guid, objectguid | ✅ Yes | A unique ID used to match and update user records across uploads. This value should remain consistent. |
| User Email | email, mail | ✅ Yes | The user’s email address—used for registration and communication. |
| First Name | first_name, firstname, given_name, givenname | No | Optional. Used for personalization. |
| Last Name | last_name, lastname, surname, sn | No | Optional. Used for personalization. |
| Manager Email | manager | No | Optional. Helps define reporting relationships. |
| Department | department | No | Optional. Used for team-based analysis and insights. |
| Job Function | job_title, jobtitle, job_function, jobfunction | No | Optional. Helps refine user segmentation. |
| Date of Birth | date_of_birth, dateofbirth, dob | No | Optional. 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.