Skip to main content
PATCH
/
payroll
/
employees
Update an employee
curl --request PATCH \
  --url https://api.app.lastaccountingcompany.com/portal/payroll/employees \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customer_id": "<string>",
  "period": "<string>",
  "employee_id": "<string>",
  "employee_key": "<string>",
  "name": "<string>",
  "tax_identifier": "<string>",
  "iban": "<string>",
  "bic": "<string>",
  "start_date": "<string>",
  "end_date": "<string>",
  "contract_id": "<string>",
  "employment_type": "<string>",
  "monthly_salary_cents": 123,
  "hourly_rate_cents": 123,
  "weekly_hours": 123,
  "withholding_basis_points": 123,
  "pension_basis_points": 123,
  "tax_card_additional_basis_points": 123,
  "tax_card_income_ceiling_cents": 123,
  "tax_card_effective_from": "<string>"
}
'
{}

Authorizations

Authorization
string
header
required

Firebase ID token from an interactive portal session. Required for admin/approver-only operations (payroll approval, company settings, API-key management).

Body

application/json

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

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.