Add an employee
NOT available to API keys — requires an interactive admin/approver session. Adds an employee to payroll. Salary and rate fields are integer cents; withholding/pension rates are basis points (10000 = 100%).
Authorizations
Firebase ID token from an interactive portal session. Required for admin/approver-only operations (payroll approval, company settings, API-key management).
Body
Employee create/update input. Salary and rate fields are integer cents; withholding and pension rates are basis points (10000 = 100%). Identify an existing employee with employee_id or employee_key when updating.
Target company. Optional for API keys.
Payroll period, YYYY-MM.
Finnish personal identity code (henkilötunnus).
Employment start, YYYY-MM-DD.
Employment end, YYYY-MM-DD.
Monthly salary in integer cents.
Hourly rate in integer cents.
Base withholding rate in basis points.
Employee pension rate in basis points.
Additional withholding rate in basis points.
Tax-card income ceiling in integer cents.
Tax card effective-from date, YYYY-MM-DD.
Response
Updated payroll workspace.
The payroll workspace for a period: employees, employer settings, and runs. Amounts are integer cents; rates are basis points. Interior shapes beyond the top level vary and are returned as-is.