> ## Documentation Index
> Fetch the complete documentation index at: https://docs.weaveos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HR platforms

> Connect your HR system to sync employee data, compensation, and time off

Connect your HR platform to Weave through [Merge](https://merge.dev), a unified HRIS API. This gives Weave access to employee records, compensation data, and time-off schedules — enabling accurate out-of-office tracking, financial metrics, and automatic team member discovery.

## Supported platforms

Weave supports a curated set of popular HR platforms out of the box:

| Platform |
| - |
| [**Workday**](https://www.workday.com) |
| [**BambooHR**](https://www.bamboohr.com) |
| [**Personio**](https://www.personio.com) |
| [**UKG Pro**](https://www.ukg.com) |
| [**ADP Workforce Now**](https://www.adp.com) |
| [**Gusto**](https://www.gusto.com) |
| [**Rippling**](https://www.rippling.com) |
| [**Paychex**](https://www.paychex.com) |
| [**Deel**](https://www.deel.com) |

Don't see your platform? Select **Other** during setup to browse 50+ additional HRIS providers supported through Merge.

## What's synced

| Data | Details |
| - | - |
| **Employees** | Names, work emails, employment status (active, inactive, pending), and manager relationships |
| **Compensation** | Hourly rate (derived from annual salary), currency, and effective date. Tracked as change history. |
| **Time off** | Approved leave requests with start and end dates and category |
| **HR attributes (tags)** | Department, cost center, business unit, group memberships, and job title — synced into Weave's tag system for filtering and dashboards |

<Note>
  Only **approved** time-off requests are synced. Pending or denied requests are excluded.
</Note>

## Why connect your HR platform

* **Automatic out-of-office tracking** — Approved time off syncs directly into Weave alongside any [manual days-off entry](/settings/out-of-office), ensuring metrics account for engineer availability
* **Accurate financial metrics** — HR salary data provides per-engineer hourly rates for [AI ROI](/reports/ai-roi) and cost calculations, preferred over the organization default rate
* **Automatic account linking** — Weave matches HR employees to existing accounts by email, reducing manual setup
* **Team member discovery** — Unlinked HR employees appear as potential members you can add to your organization

## Connecting your HR platform

<Steps>
  <Step title="Navigate to HR integration">
    Go to the **Data** page and click **Connect** on the HR integration card. You can also access it directly at **Settings > HR integration**.
  </Step>

  <Step title="Select your platform">
    Choose your HR platform from the grid. If your platform isn't listed, select **Other** to browse all supported providers.
  </Step>

  <Step title="Authorize access">
    A Merge Link window opens. Sign in to your HR system and grant Weave read access to employee data. The specific authorization steps vary by platform.
  </Step>

  <Step title="Wait for initial sync">
    After authorization, Weave automatically syncs your employee directory, compensation records, and approved time off. This typically completes within a few minutes.
  </Step>
</Steps>

### Requirements

* You must have the **admin** role or **Manage connections** permission in Weave
* Your Weave account must have an email address set

## Account linking

After the initial sync, Weave automatically links HR employees to existing Weave accounts by matching email addresses. This powers per-engineer metrics like time off and financial calculations.

### How auto-linking works

1. Weave compares each HR employee's work email against Weave account emails
2. Matches are linked automatically — no manual action needed
3. Unlinked HR employees appear as **potential members** on the team management page

### Manual linking

If an employee's HR email doesn't match their Weave account email, you can link them manually from the member's profile in [team management](/team-management/suggested-members).

## Features enabled

### Out-of-office tracking

HR time-off data is combined with any [manually entered days off](/settings/out-of-office) in Weave. Metrics automatically adjust for engineer availability, so time away doesn't skew productivity calculations.

### Financial metrics and hourly rates

When HR salary data is available for a linked member, Weave uses their actual hourly rate (derived from annual compensation) instead of the organization's default rate. This improves the accuracy of:

* [AI ROI reports](/reports/ai-roi) — cost savings based on real compensation
* Per-engineer cost calculations across dashboards

<Tip>
  Salary data is never displayed to any users on the platform.
</Tip>

### Suggested members

HR employees who aren't yet linked to a Weave account appear as suggested members. This helps you discover engineers who should be tracked in Weave but haven't been added yet.

### HR attributes for filtering and dashboards

Weave syncs common HR attributes into its tag system so you can segment metrics without manual setup:

* **Department**, **Cost center**, **Business unit**, and **Group** memberships
* **Job title** from each employee's latest employment record

These appear as tag categories on linked members. Use them in report filters, drill-downs, and [custom dashboards](/features/custom-dashboards) — including prebuilt **Output by department**, **Output by cost centre**, and **Output by job title** charts (available once HR sync has populated the tags).

<Note>
  Weave's native **Teams** concept is separate from HR group memberships. Merge's `TEAM` group type is intentionally not synced as a tag to avoid duplicating team structure.
</Note>

## Data privacy

Weave handles HR data with care:

* **Limited scope** — Only employee directory information, compensation rates, and approved time off are synced. No performance reviews, personal documents, or sensitive HR records.
* **Compensation privacy** — Salary data is used solely for organization-level financial calculations and is never displayed to any users on the platform.
* **Encryption** — All data is encrypted in transit and at rest
* **Access control** — Only organization admins can connect, configure, or disconnect the HR integration

## Sync frequency

After the initial sync, Weave periodically refreshes data from your HR platform. Changes to employee status, new hires, compensation updates, and approved time off are picked up automatically.

You can trigger a manual refresh by clicking **Refresh status** on the HR integration configuration page.

## Troubleshooting

<AccordionGroup>
  <Accordion icon="users" title="Employees not syncing">
    If employees from your HR system aren't appearing in Weave:

    1. Verify the HR connection is active on the **Data** page
    2. Click **Refresh status** on the HR configuration page to trigger a re-sync
    3. Check that the employees exist in your HR system with an active status
    4. If the issue persists, disconnect and reconnect the integration
  </Accordion>

  <Accordion icon="link" title="Accounts not auto-linked">
    If HR employees aren't automatically linked to Weave accounts:

    1. Ensure the employee's work email in the HR system matches their Weave account email
    2. Check that the employee has a work email set in the HR system (some platforms use personal emails by default)
    3. Link accounts manually from the member's profile in team management
  </Accordion>

  <Accordion icon="dollar-sign" title="Salary data not appearing in financial metrics">
    If hourly rates aren't being used from HR data:

    1. Verify the employee has employment/compensation records in the HR system
    2. Check that the HR employee is linked to a Weave account
    3. Note that not all HRIS providers expose compensation data through their API — this varies by platform and plan
  </Accordion>

  <Accordion icon="calendar-x" title="Time off not showing">
    If approved time off isn't reflected in Weave:

    1. Confirm the time-off request is **approved** in the HR system (pending and denied requests are excluded)
    2. Verify the employee is linked to a Weave account
    3. Wait for the next sync cycle or trigger a manual refresh
    4. Check that your HR platform supports time-off data through the Merge API
  </Accordion>

  <Accordion icon="plug" title="Connection errors">
    If the integration shows errors or won't connect:

    1. Verify your HR platform credentials are still valid
    2. Check that your HR platform plan includes API access
    3. Try disconnecting and reconnecting the integration
    4. Contact support at [support@workweave.ai](mailto:support@workweave.ai) if errors persist
  </Accordion>
</AccordionGroup>

## Disconnecting

To disconnect your HR integration:

1. Go to the **Data** page and click **Configure** on the HR integration card
2. Click **Disconnect**
3. Confirm the disconnection

<Warning>
  Disconnecting removes the link between Weave and your HR platform. Previously synced employee links, compensation data, and time-off records will no longer update. Existing account links are preserved but won't receive new data.
</Warning>

## Related

* [Out of office](/settings/out-of-office) — Add PTO and days off manually in Weave
* [AI ROI report](/reports/ai-roi) — Financial impact calculations using HR salary data
* [Suggested members](/team-management/suggested-members) — Discover team members from connected data sources
* [Team hierarchies](/team-management/team-hierarchies) — Organize your team structure


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.