Articles on: Integrations

How to Connect and Configure Humanforce HR (intelliHR)

How to Connect and Configure Humanforce HR (intelliHR)


In this article:

  • Overview
  • Before you start
  • How to connect Humanforce HR
  • Choosing your settings
  • Sending learning, certificates and skills to Humanforce HR
  • Additional actions
  • Things to keep in mind
  • FAQs
  • Who can do this


Overview


The Humanforce HR integration (formerly intelliHR) keeps your people and teams in SuperPath in step with Humanforce HR. New starters are created in SuperPath, changes to their details, job and manager flow across, and leavers are disabled, all without anyone exporting a spreadsheet.


It can also work the other way. Completed learning can be added to each person's Humanforce HR training record, earned Certificates can become qualifications with the certificate PDF in their Documents, and skills can be shared in both directions. Each of these is off until you turn it on.


You connect with your Humanforce HR tenant name and an API key. SuperPath registers its own webhooks when you connect, and removes them when you disconnect. If you plan to send learning to Humanforce HR, you also create one training provider there first (see Before you start).


Before you start


You will need:

  • Your tenant name. This is the first part of your Humanforce HR web address. If you sign in at acme.intellihr.net, your tenant name is acme.
  • An API key. In Humanforce HR, go to Settings → Public API Access Keys and create a key. Every Humanforce HR API key has full administrator access, so store it somewhere safe and only paste it into SuperPath.


If you plan to send learning to Humanforce HR, create a SuperPath training provider:


Every training record SuperPath sends is filed under a training provider called SuperPath, so your HR team can see at a glance which records came from SuperPath. Humanforce HR does not let other systems create training providers, so this is the one thing you set up by hand. You only do it once.


  1. In Humanforce HR, go to Settings → Training Providers.
  2. Add a new training provider and name it exactly SuperPath.
  3. Make sure it is enabled, then save.


SuperPath looks for an enabled provider with exactly this name. Capital letters and spaces at either end do not matter, but a different name such as SuperPath Old or SuperPath LMS is not used. If you skip this step, or later rename or disable the provider, learning is still sent, but Humanforce HR files it under your default training provider and SuperPath adds a warning to View Integration Logs, at most once a day.


If you plan to send Certificates to Humanforce HR:

  • Check you have a qualification type named Certification. SuperPath files certificates under it, or under your first qualification type if there is no Certification type.


How to connect Humanforce HR


  1. Go to Settings → Integrations.
  2. Click the Humanforce HR (intelliHR) tile. The Connect Humanforce HR (intelliHR) window opens.
  3. Choose your settings. Each one is explained in the next section, and you can change them later.
  4. Under Please provide following connection details, enter your Tenant name and API key.
  5. If you set Company user creation, enter your Company email domain too.
  6. Click Connect Humanforce HR (intelliHR).


SuperPath saves your details straight away and then checks them with Humanforce HR in the background. Within a minute or so, open View Integration Logs under your integrations to see the result.


  • Connected: a success log confirms the connection and that the webhooks are registered. Check your settings, then click Refresh people and teams under Additional actions to bring in your people.
  • Not connected: a failed log reads "Humanforce HR did not accept the tenant name and API key." Humanforce HR gives the same answer for a wrong key and a wrong tenant name, so check both, correct them in the integration settings and save again.


Tip: The Test Integration button checks your saved tenant name and API key with Humanforce HR on demand.


Choosing your settings


User creation

How new people from Humanforce HR are added to SuperPath. Existing SuperPath users are matched by email and kept up to date whichever option you choose.


  • Manual: nobody is created or invited. You add people yourself, and once they exist their details are kept in sync.
  • Invite Users: people are sent an invitation and appear in SuperPath once they accept it.
  • Create with Password: people are created with a password and are not notified. Send them a welcome email from the People list, turn on Send welcome email, or they can use the forgotten password option.
  • Create with Magic Link: people are created with no password and sign in with a link sent to their email. They are not notified unless Send welcome email is on.
  • Create with Google: people are created to sign in with the Google account that matches their email.
  • Create with Microsoft: people are created to sign in with the Microsoft account that matches their email.
  • Create with SAML: people are created to sign in through the SAML single sign-on set up in your SuperPath security settings.


Company user creation and Company email domain

Use these when your company staff should sign in differently from everyone else, for example staff on Microsoft and contractors on personal email addresses with a password. Set Company user creation to the method for your staff and enter your domain in Company email domain, without the @. Separate several domains with commas, for example company.com, company.com.au.


Anyone whose email domain matches exactly is created with the company method. This takes priority over every User creation option, including Manual and Invite Users. Everyone else follows User creation. Subdomains do not match, so au.company.com is not covered by company.com. Leave Company user creation on Same as user creation to treat everyone alike. See How to Set a Second Authentication Type for Company Staff for more examples.


Email to use

Which Humanforce HR email address SuperPath uses to match and create people.

  • Primary email: the person's primary email address in Humanforce HR.
  • Work email, fall back to primary: a work (not personal) email when the person has one, otherwise their primary email.


People with no usable email address are not synced, and a failed log names them.


Team mapping

How Humanforce HR places people into SuperPath Teams. Teams are named after each person's primary job.

  • Business Unit: one Team per business unit.
  • Location: one Team per location.
  • Business Unit and Location: each person joins both.
  • None: Humanforce HR does not manage Team membership.


Send welcome email

Sends a welcome email to people when they are created. It is not used for Manual or Invite Users, because invitations send their own email.


Sync upcoming staff

When on, people are created before their start date so you can assign pre-boarding learning. When off, they are created once their job starts.


Turning this on does not add anyone straight away. Future starters who were skipped while it was off are added the next time you click Refresh people and teams, or overnight if their record changed in Humanforce HR in the last three days.


Sending learning, certificates and skills to Humanforce HR


All of these settings are off by default. Turn on only the ones you want.


Sync assignments and Sync pathways

  • Sync assignments: when someone completes assigned content, an Event, a Form or a Pathway step, it is added to their Humanforce HR training record.
  • Sync pathways: when someone completes a Pathway, it is added to their training record.


Only learning that has Sync with HRIS turned on is sent, and a scored course or Pathway is only sent once the person has passed it. Each record is marked Completed with the completion date, the learning time as hours, and the cost when one is set. It is filed under your SuperPath training provider and your default training type.


Learning that is already in Humanforce HR is linked rather than added twice, even if it has been renamed in SuperPath. To make this work, SuperPath adds a field called SuperPath learning id to each record it sends, which you will see in the record's additional details. If you delete the learning in SuperPath, its training record is removed from Humanforce HR.


Sync certificates

When someone earns a Certificate, it is added to their Humanforce HR profile as a current qualification with its issue and expiry dates, and the certificate PDF is added to their Documents. If the awarded or expiry date changes, the qualification is updated. If you remove the Certificate in SuperPath, the qualification is removed, but the PDF stays in their Documents.


Skills

  • Import skills from Humanforce HR: brings your Humanforce HR skills catalogue into SuperPath, with each discipline as the category. A SuperPath skill with the same name is linked and keeps its levels. Linked skills are managed in Humanforce HR and cannot be edited in SuperPath. A skill removed from Humanforce HR stays in SuperPath.
  • Send user skills to Humanforce HR: when someone earns a skill in SuperPath, it is added to their Humanforce HR profile at the matching level. Beginner becomes Basic, Intermediate and Advanced become Proficient, Expert stays Expert, and a skill with no level is sent as Proficient. A level that is already higher in Humanforce HR is never lowered.
  • Remove skills from Humanforce HR: when someone no longer has a skill in SuperPath, it is removed from their Humanforce HR profile. Leave this off if your HR team also records skills by hand.


Additional actions


These appear under Additional actions on the integration once it is connected.


  • Refresh people and teams: syncs every person from Humanforce HR now and repairs the webhook connection. Use it after first connecting, or if changes stop coming through.
  • Resync last 24 hours: syncs everyone whose Humanforce HR record changed in the last 24 hours. A similar sync also runs automatically every night, covering the last three days.
  • Resync learning: sends completed learning (and Certificates, if Sync certificates is on) that is not in Humanforce HR yet. Use it after turning a sync setting on, to bring across what was completed beforehand. It is safe to run more than once.
  • Resync skills: imports the skills catalogue now, then sends every synced person's skills. Large teams take a while, because each person is checked in turn.


To resync one person, open their profile from People and click Resync with Humanforce HR in the buttons at the top of the profile. A message confirms the resync has started, and their details are refreshed from Humanforce HR. The button only shows for people who are linked to Humanforce HR.


Things to keep in mind

  • Changes in Humanforce HR usually reach SuperPath within a couple of minutes, but Humanforce HR can occasionally take longer to send them. The nightly sync catches anything that was missed.
  • When someone's job ends in Humanforce HR, their SuperPath account is disabled. Their learning history is kept.
  • A job only counts as ended once its end date is finalised. Until someone clicks Finalise Company End Date on the job in Humanforce HR, the job shows as ending and the person stays active in SuperPath, even after the end date has passed.
  • Supervisors in Humanforce HR are given the People Manager role in SuperPath, and go back to Employee if they stop being a supervisor. Owners, Admins, Managers, Content Managers and Instructors keep the role you gave them. If your organisation has Use Teams for Managers turned on, roles are not changed by the sync.
  • Each person's supervisor in Humanforce HR becomes their line manager in SuperPath.
  • Disconnecting removes SuperPath's webhooks from Humanforce HR. The people and Teams already synced stay in SuperPath.
  • If you regenerate a Certificate, the new PDF is not uploaded again. The original PDF stays in the person's Documents.
  • Certificate PDFs over 25 MB are not uploaded. The qualification is still added.


FAQs


Do I need to set up webhooks in Humanforce HR?
No. SuperPath registers its webhooks when you connect and removes them when you disconnect. If one is deleted by mistake, Refresh people and teams or the nightly sync puts it back.


Why was a training record sent with a different training provider?
SuperPath could not find an enabled training provider named exactly SuperPath, so the record was sent with your default provider and a warning was logged. Create or enable the SuperPath provider in Humanforce HR, and later records will use it.


What is the SuperPath learning id field on training records?
SuperPath uses it to recognise records it has already sent, so a renamed course is never added twice. Please leave it in place.


Can I change the API key or tenant name later?
Yes. Open the integration, update the details and save. Check View Integration Logs afterwards to confirm Humanforce HR accepted them.


Why can't I edit a skill in SuperPath?
It is linked to your Humanforce HR skills catalogue, so it is managed there. Edit it in Humanforce HR and the change comes across on the next sync.


Who can do this

Owners and Admins can connect, configure and disconnect the Humanforce HR integration, run its additional actions, and resync a person. Managers, Content Managers, People Managers, Instructors, Employees and Restricted users cannot see the Integrations settings. If your organisation's account is managed by a partner, the partner may have turned off access to integration settings.

Updated on: 09/11/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!