Humanforce Integration

FairTest integrates with Humanforce WFM to sync employee data and track clock-in status, enabling real-time "who's on shift" selections.

Capabilities

Capability	Description
Employee Sync	Import and update employee records from Humanforce
Clock-in	Use "HF On Shift" as a selection pool to select only employees currently clocked in

Connecting to Humanforce

Humanforce connects using API credentials.

1. Go to Setup > Integrations
2. Click Configure next to Humanforce
3. Enter your credentials:
   • API Host — your Humanforce API endpoint
   • API Key — your Humanforce API key
   • API Secret — your Humanforce API secret
4. Click Connect to Humanforce

The connection is automatically tested on submit. If the credentials are invalid, you will see an error message.

Entity Mapping Configuration

After connecting, configure how Humanforce entities map to FairTest:

FairTest Entity	Maps From
Location	Location
Department	Department
Job Classification	Role

Each mapping shows the found entities below the dropdown, so you can verify the data before proceeding.

Assigning Entities

After reviewing the mapping configuration, go to the corresponding Setup pages and assign the correct Humanforce entity to each FairTest record:

1. Setup > Locations — assign the Humanforce location to each FairTest location
2. Setup > Departments — assign the Humanforce department to each FairTest department
3. Setup > Job Classifications — assign the Humanforce role to each FairTest job classification

Managing the Connection

• Test Connection — verify your Humanforce credentials are still valid
• Enable/Disable toggle — turn the integration on or off without losing your configuration

---

Related Articles:

• Managing Locations
• Running a Selection