This article explains the Humanforce IntelliHR integration for Traffio.

The integration keeps selected IntelliHR people, employment details and qualifications aligned with Traffio. It supports both manual Sync and real-time updates through webhooks.

Before creating people or enabling webhooks, connect IntelliHR and complete the mappings that apply to your workforce. This helps prevent duplicate people, incorrect depot assignments, and unwanted specialisations or skills.

Sync refreshes IntelliHR records in Traffio, updates people who are already mapped, and reconciles mapped qualifications into Traffio Skills. It does not create Traffio people or people mappings.

Mapping tells Traffio which Traffio record represents an IntelliHR record.

Create Traffio Person is an explicit action on the People mapping screen. It creates and maps one selected, active IntelliHR person.

Webhooks process supported IntelliHR changes between manual syncs. A new eligible person can be created automatically only from an IntelliHR job.created webhook.

Enter the Tenant Name generated for the IntelliHR API key—not an alias or display name—and an active API key.

Traffio encrypts and securely stores the API key. You can replace the key at any time. The tenant name is locked after the connection is established so an existing connection cannot accidentally be linked to another IntelliHR tenant.

On first save, Traffio retrieves position titles, locations and qualification library items. Configure the Position Title Filter, then use Sync to retrieve matching jobs for People mapping.

Last Synced shows when the most recent manual Sync completed successfully. It is not updated for a failed or incomplete sync.

The Position Title Filter controls which IntelliHR jobs are stored and shown on the People mapping screen. It also controls which new people may be automatically created by a job.created webhook.

Select only the position titles that should be managed through this integration. Changing the filter does not delete existing Traffio people or mappings. To make jobs for newly selected position titles available, save the setting and run Sync.

An existing person mapping can continue to be updated from its mapped IntelliHR job, even if that job’s position title is later removed from the filter.

Select a Default Person Depot before creating people.

When Traffio creates a person from IntelliHR, it uses the depot mapped from the person’s IntelliHR Location. If there is no Location-to-Depot mapping, it uses the Default Person Depot. Changing this setting does not move people who already exist in Traffio.

Enable this setting to let Traffio process supported real-time changes from IntelliHR.

When you turn this setting on and save, Traffio checks that its required IntelliHR webhooks exist and are enabled. If a required webhook has been deleted in IntelliHR, Traffio recreates it. If one is disabled, Traffio re-enables it automatically.

Turning this setting off stops Traffio processing incoming webhook events, including events already queued for processing.

If something goes wrong with webhooks and you'd like to reconfigure them, follow these steps:

Important: Please don't modify these webhooks from within your IntelliHR portal.

Use the Sync button to refresh IntelliHR data in Traffio. It retrieves changed position titles, locations, qualifications and jobs.

Jobs matching the Position Title Filter are made available for People mapping. Sync updates existing mapped Traffio people from their mapped, active IntelliHR job. It does not create Traffio people or people mappings.

Manual Sync also reconciles qualifications for mapped people:

Use Sync when:

Note: IntelliHR does not provide a webhook for qualification deletion. Run Sync after removing a qualification in IntelliHR so Traffio can expire the corresponding integration-managed Skill when appropriate.

Mappings are connection-specific. The IntelliHR record appears on the left of each mapping screen and the corresponding Traffio record is selected on the right.

A People mapping links an IntelliHR person/job to an existing Traffio person. Map people who already exist in Traffio before enabling ongoing updates; this avoids duplicate people being created.

For a mapped person, Traffio updates integration-managed information including personal and contact details, address, emergency contact, job title, employment dates, employment type and mapped specialisation. Employment details are taken only from the IntelliHR job selected in the person’s mapping.

For an unmapped job shown on the screen, Create Traffio Person opens a prefilled Person form. After you save the person, Traffio saves the People mapping. Check that the job is active before creating the person. Creating the person does not import their existing IntelliHR qualifications. After the People mapping has saved, run Sync to create Person Skills for Current qualifications that have a Qualifications mapping.

A Position Titles mapping links an IntelliHR Position Title to a Traffio Specialisation.

When an IntelliHR job is used to create or update a person, Traffio applies the mapped Specialisation. If the position title is not mapped, Traffio can still store the job title but does not assign a Specialisation from the integration.

The Position Title mapping does not determine which jobs are available for People mapping; the Position Title Filter does that.

A Locations mapping links an IntelliHR Location to a Traffio Depot.

The mapping is used when Traffio creates a new person. If the person’s Location is not mapped, Traffio uses the Default Person Depot. Updating an existing mapped person does not automatically move them to a different Depot when their IntelliHR Location changes.

A Qualifications mapping links an IntelliHR Qualification Library Item to a Traffio Skill.

A qualification affects a Traffio Person Skill only when:

Traffio retains the selected qualification instance as the source for the Person Skill. When a newer current renewal becomes the selected source, Traffio updates the Person Skill dates and retires the previous source.

With webhooks enabled, Traffio processes these supported IntelliHR events:

Updates the matching mapped person’s personal, contact, address and emergency-contact details.

Soft-deletes the matching mapped Traffio person.

For an unmapped person, Traffio creates and maps a person only when the job is active, primary and matches the Position Title Filter. It does not overwrite an existing mapping.

Refreshes the mapped person’s job-derived details when the job is authoritative (the person’s mapped, active IntelliHR job) for that mapping.

Refreshes the mapped person’s employment dates when the job is authoritative (the person’s mapped, active IntelliHR job) for that mapping.

Marks the stored IntelliHR job as inactive.

Traffio refreshes the relevant qualification instances and selects the current instance that should drive the mapped Traffio Skill. It creates or updates the Skill only when both the qualification and person are mapped.

Webhooks complement manual Sync. Run Sync after broad IntelliHR changes, qualification removals or Position Title Filter changes.