---
title: "Update an employee"
method: PATCH
path: "/payroll/employees"
tags: ["Payroll"]
---

# Update an employee

`PATCH /payroll/employees`

NOT available to API keys — requires an interactive admin/approver session. Partially updates an employee identified by `employee_id` or `employee_key`. Same units as creation: integer cents and basis points.

## Request body

- PayrollEmployeeInput — 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.
  - `customer_id` string — Target company. Optional for API keys.
  - `period` string — Payroll period, `YYYY-MM`.
  - `employee_id` string
  - `employee_key` string
  - `name` string
  - `tax_identifier` string — Finnish personal identity code (henkilötunnus).
  - `iban` string
  - `bic` string
  - `start_date` string — Employment start, `YYYY-MM-DD`.
  - `end_date` string — Employment end, `YYYY-MM-DD`.
  - `contract_id` string
  - `employment_type` string
  - `monthly_salary_cents` integer — Monthly salary in integer cents.
  - `hourly_rate_cents` integer — Hourly rate in integer cents.
  - `weekly_hours` number
  - `withholding_basis_points` integer — Base withholding rate in basis points.
  - `pension_basis_points` integer — Employee pension rate in basis points.
  - `tax_card_additional_basis_points` integer — Additional withholding rate in basis points.
  - `tax_card_income_ceiling_cents` integer — Tax-card income ceiling in integer cents.
  - `tax_card_effective_from` string — Tax card effective-from date, `YYYY-MM-DD`.

## Response `200`

Updated payroll workspace.

- PayrollWorkspaceData — 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.

## Other responses

- `401` — Missing or invalid bearer token.
- `403` — Insufficient scope or role — e.g. a read-scoped key on a mutating method, or an API key on an admin/approver-only endpoint.

---

[API](https://skmtc.net/lastaccountingcompany/apis/lac-customer-api.md) · [All operations](https://skmtc.net/lastaccountingcompany/apis/lac-customer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lastaccountingcompany/lac-customer-api/versions/52e277b4f031/schema)