---
title: "Create wage group employee settings."
method: POST
path: "/wage_group_employee_setting/upsert"
tags: ["Cost control|Wage group employee setting"]
---

# Create wage group employee settings.

`POST /wage_group_employee_setting/upsert`

This endpoint enables you to create new wage group employee settings.

## Request body

- StandardWageGroupEmployeeHistoryUpsertRequest
  - `records` object[] — The wage group employee setting data.
    - `keyField` string — This parameter specifies the name of the unique key used to distinctly assign each dataset in the API. | Value | Description | |----------------|-----------------------------| | id | The internal employee cost setting ID |
    - `data` WageGroupEmployeeHistoryUpsertRequestRecordData
      - `employeeId` integer — The internal id of the employee if the setting is meant to be for a employee.
      - `departmentId` integer — The internal id of the department if the setting is meant to be for a department.
      - `from` string — Represents a date. (ISO 8601) ICU-Format: yyyy-MM-dd
      - `wageGroupSource` string — The source for the wage group. | Value | Description | |------|-------------| | EMPLOYEE | wage group is defined at this entry | | DEPPARTMENT | wage group is defined at the department | The value "DEPARTMENT" can only be set if an employeeId is given. This will link the settings wage group to the one of the departments. If an employeeId is given the value can also be set to "EMPLOYEE". This will set the wage group for this specific employee. In that case a wage group also has to be given. For a department this value is obsolete.
      - `wageGroupId` integer — The wage group for this setting. Value is needed for settings if a departmentId is given or the wageGroupSource is set to "EMPLOYEE".
      - `fallbackProjectId` integer — This project will be used for cost bookings that have no assigned project.
      - `automaticBooking` boolean — This value indicates whether this setting should be used to create automatic bookings. Can be set to false if this setting is supposed to be used for form data bookings.
  - `startCostCalculation` boolean — If true a cost calculation will be started from the start date of this setting on.
  - `dryRun` boolean — Simulate the operation. (No records will be created or changed) This Parameter is optional.

## Response `200`

Success Response:

- StandardWageGroupEmployeeHistoryUpsertResponse
  - `createdWageGroupEmployeeSettings` object[] — The created wage group employee settings.
    - `id` integer — The internal id of the wage group employee setting.
    - `employee` StandardWageGroupEmployeeHistoryBaseEmployeeItem
      - `id` integer — The internal employee ID.
      - `reference` string — The personal number. (max. 20 characters)
      - `cardNumber` string — The driver card number.
      - `importSource` string — External data source from which this employee originates. (max. 16 characters)
      - `importKey` string — External ID from the respective data source. (max. 64 characters)
      - `firstName` string — The first name of the employee. (max. 128 characters)
      - `lastName` string — The last name of the Employee. (max. 128 characters)
      - `name` string — This field is deprecated. Please use firstName The complete Name of the Employee If first name or last name is set, name is ignored.
    - `department` DepartmentFetchResponseDepartmentItem
      - `id` integer — The internal id of the department.
      - `name` string — The name of the department.
      - `parent` string — The name of the departments parent.
    - `wageGroupSource` string — The source of the wage group for this setting.
    - `wageGroup` StandardWageGroupBaseWageGroupListItem
      - `id` integer — The internal id of the wage group.
      - `name` string — The name of the wage group.
      - `externalId` string — The external id of the wage group.
      - `createdAt` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx
    - `fallbackProject` number — The fallback project for this setting.
    - `automaticBooking` number — This indicates whether this setting should be used to create cost bookings automatically.
    - `from` string — Represents a date. (ISO 8601) ICU-Format: yyyy-MM-dd
    - `to` string — Represents a date. (ISO 8601) ICU-Format: yyyy-MM-dd

---

[API](https://skmtc.net/geocapture/apis/geocapture-api.md) · [All operations](https://skmtc.net/geocapture/apis/geocapture-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/geocapture/geocapture-api/versions/869b05603541/schema)