For the complete documentation index, see llms.txt. This page is also available as Markdown.

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 SettingsHR 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.

  • Go to SettingsHR 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:

  1. Go to SettingsHR system.

  2. Click Connect.

  3. Select your HR system.

  4. Click I am an admin.

  5. 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?