Skip to main content

​
HR → Payroll employee sync

Fluide HR is the canonical source for employee and contract data. When you create or update records via the HR API, Payroll receives those records automatically.
Call the public HR and Payroll APIs. Sync happens inside the platform. This guide is the behavior you can rely on when a payroll list is briefly behind HR.

​
When sync happens

​
Idempotency

Payroll employees.id equals the canonical HR employee UUID. Replaying the same create or update updates the same Payroll row — safe to retry. Contract rows may use the same UUID as hr_employment_contract.id when HR sends contract.id.

​
Steps (integrator workflow)

1

Create employee in HR

2

Wait for sync (usually seconds)

Payroll picks up the HR record shortly after the HR request succeeds.
3

Verify in Payroll API

The employee id should match HR data.id.
4

Proceed to payroll run

Once mirrored, include the employee in a run — Run payroll.

​
Troubleshooting

Add an employee

Create the canonical HR record.

Run payroll

Process pay after sync.