Merge.dev
Connect Swarmia to your HR system through Merge.dev, a universal HR connector.
Merge.dev is a universal HR connector that lets Swarmia integrate with a wide range of HR providers. Use it when your HR system doesn't have a direct integration yet.
Prerequisites
You need to be a Swarmia admin for your organization.
You need to be an admin for your HR system (path 1), or have your HR system admin complete the setup (path 2).
Path 1: Set it up directly
Go to Settings → HR system.
Under Don't see your HR system?, click Connect (you'll need to be an admin in your HR system to complete this path).
Select your HR system and follow the instructions provided by Merge.dev to complete the integration.
Once complete, you'll see a Connected indicator in the Swarmia settings.
Path 2: Share the link with your HR admin
Go to Settings → HR system.
Click the Share link below the Connect section. This copies a unique link to your clipboard. The link expires in 7 days.
Share the link with your HR system administrator. The page prompts them to select your HR system and follow the instructions provided by Merge.dev to complete the integration.
Once complete, you'll see a Connected indicator in the Swarmia settings.
Check HR system access permissions
Before connecting through Merge.dev, you can review the permissions that will be requested:
Go to Settings → HR system.
Click Connect.
Select your HR system.
Click I am an admin.
Review the requested permissions.
Check the integration is working
After connecting, you can verify the integration on the HR system settings page, which shows the current sync status of your HR data.
Make sure all team members are linked
Once you've connected your HR system, Swarmia automatically matches your employees to existing Swarmia profiles. Go to Contributors under Settings → Team & Members to see how your employees have matched.
Each contributor matched with your HR system has a corresponding logo below their name and email address.
When Swarmia isn't entirely confident about the match, you may see suggestions to merge profiles from different systems. These suggestions appear on the right side of the contributors table.
Data usage
Swarmia collects only the minimum data required to improve developer metrics and contributor matching.
Employee data
Unique identifier for the employee.
Full name (for debugging purposes).
Work email for matching with Swarmia profiles.
Time off data
Status of the time off (approved, pending, etc.).
Start date/time of the time off period.
End date/time of the time off period.
Reference to the employee ID.
During initial setup, Swarmia syncs time off data from the past 2 years. Ongoing updates are synced automatically.
This data is used to:
Match employees in your HR system with contributors in Swarmia.
Account for time off when calculating developer effort metrics.
Show time off in the work log (when grouped by author).
Supported HR systems
What data Swarmia can access depends on how your HR system handles permissions. Some systems give you more control than others. Merge.dev documentation provides more details on each system.
Let us know if you don't find your HR system in the list below.
ADP Workforce Now
AlexisHR
Breathe
Charlie
Dayforce
Factorial
Freshteam
Hibob
HR Partner
Humaans
Justworks
Keka
Lucca
Officient
Paycor
PeopleHR
Personio
Sage HR
Sage People
Sesame
Square Payroll
TriNet HR Platform
UKG Pro Workforce Management
Last updated
Was this helpful?