Deputy Integration
FairTest integrates with Deputy to sync employee data and track clock-in status, enabling real-time "who's on shift" selections for drug and alcohol testing.
Capabilities
| Capability | Description |
|---|---|
| Employee Sync | Import and update employee records from Deputy |
| Clock-in Status | Use "Deputy Clocked In" as a selection pool to select only employees currently on shift |
Connecting to Deputy
- Go to Setup > Integrations
- Click Connect to Deputy
- You will be redirected to Deputy's login page
- Sign in to your Deputy account and grant FairTest access
- You will be returned to FairTest automatically
Once connected, the integration status will show:
- Green dot — Connected & Enabled — the integration is active and syncing
- Yellow dot — Connected (Disabled) — credentials are saved but the integration is turned off
Managing the Connection
- Test Connection — click to verify your Deputy credentials are still valid
- Enable/Disable toggle — turn the integration on or off without losing your configuration
Configuring Location Mapping
After connecting, you need to map your Deputy locations to your FairTest locations:
- Go to Setup > Locations
- For each location, set the Deputy Location ID to match the corresponding location in Deputy
- This mapping is required for employee imports and clock-in selections to work correctly
Importing Employees
- Go to Employees
- Click Import from Deputy
- FairTest fetches your current Deputy roster and imports employees
Employees are matched by their Deputy ID. Re-running the import will update existing records rather than creating duplicates.
Running a Clock-in Selection
- Go to Selections and click New Selection
- Choose Deputy Clocked In as the pool type
- FairTest queries Deputy for employees currently clocked in
- Only employees who are actively on shift are included in the selection pool
Related Articles: