Skip to content
  • There are no suggestions because the search field is empty.

How to add people to Huma

Add employees one at a time, import multiple people, or connect via an integration

 

Table of Contents

 

 

 

Roles and access

To add new employees to Huma, you need one of the following:

Access Role
Add one person or import multiple System role: Users → User management
Add one person to groups you manage User role: See and edit → Users


Example: Sarah has a user role with access to "Users" over the Oslo location only. She can add new employees, but they will be added to the Oslo location. She cannot add employees to other locations.

💡 If you are unsure which role you have, contact your system administrator.

 

 

Add one employee

Adding one person at a time is the quickest way to get a single employee into Huma. When adding a person manually, you can fill in their details, assign a supervisor, and add them to the relevant groups straight away.

  1. Go to the People module

  2. Click "Add person"

  3. Fill in the employee's details

  4. Assign a supervisor under "Supervisor" if relevant, select an employee from the list

  5. Add the employee to the relevant teams and locations under "Groups"

  6. Toggle on "Send welcome email" if you want to send an invitation straight away

  7. Click "Done", and the user is now created

     

 

 

 

💡 We recommend filling in as much information as possible when adding a new employee. The more complete the data is from the start, the less manual work you will have to do later.

🔗 Read more about the Supervisor role in Huma.

🔗 Read more about Teams and Locations.

 

Simple or detailed import file?

When importing multiple people, you can choose between two templates:

  • Simple import file — quick to fill out. Contains only the essential fields needed to create a user. Employees can complete their own profiles after logging in.
  • Detailed import file — a bit more to fill out up front, but employees will start out with a more complete profile from day one.

 

Not sure which one to choose? Here are two common scenarios:

  1. You are setting up Huma for the first time (recommended) and have employee data available in an existing HR or payroll system, go with the detailed import file. Transferring the data now means less manual work for both you and your employees later.

  2. You need to get people into the system quickly and do not have all the data at hand, go with the simple import file. You can always update employee profiles later, either manually or by running a new import.

 

💡 Whichever template you use, make sure the email address is correct, this is what employees use to log in to Huma.

 

Avoid import errors — fields that must be filled in together

Some fields in the detailed import file only work correctly when other fields are also filled in. If you fill in one without the other, the import will fail for that row.

If you fill in... You must also fill in... Notes
Any address field Address Line 1, Postal Code, City, Country Address Line 2 and 3 are optional
Bank account number Bank Country If using IBAN, provide BIC instead of Bank Country
Any employment field (contract type, percentage, job title etc.) Contract start date Without Contract start date, no position will be created
National ID number Country code prefix Format: "NO 01010012345". Must follow ISO 3166 Alpha-2 standard

 

💡 If your import fails, click "Show errors" to see exactly which rows and fields caused the issue. Fix the errors in the file and upload it again.

 

Import multiple employees

If you need to add several employees at once, you can use Huma's import template. Download the template, fill it in with your employee data, and upload it directly into Huma. Everything you fill in is automatically added to each employee's profile.

  1. Go to the People module

  2. Click "Add multiple"

  3. Choose to download a "Simple" or "Detailed" import file template

  4. Fill out the template with your employee data

  5. Click "Upload your file here" when you are done

  6. Click "Add", and the users will be imported in the background

  7. You will receive an email once the import is complete

 

 

💡 If there are errors in your file, Huma will notify you and prevent users from being added. Click "Show errors" to review and correct the issues, then upload your file again.

 

 

Import using an integration

You can also add employees by connecting Huma directly to the systems you already use, such as a payroll or HR solution. This removes the need for manual data entry and helps ensure that employee information stays up to date across all systems.

  1. Go to the People module

  2. Click "Add people"

  3. Click "Import using an integration"

  4. Choose your integration from the list

  5. Click "New connection" and follow the setup steps depending on your integration

 

🔗 Read more about integrations in Huma.