FAfactorialhr
Compensations > EmployeesCompensation

Creates an Employees compensation

Changed on

Creates an employee compensation (dashboard-created, no source)

post/api/2026-10-01/resources/compensations/employees_compensations

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/compensations/employees_compensations
  • Auth
    • OAuth 2
      Authorization code: https://id.factorialhr.com/oauth/authorize
      Token URL: https://id.factorialhr.com/api/oauth/token scopes: compensations
    • or API key in header x-api-key

Request body

payroll_run_idstring required

Parent payroll run id, refers to compensations/payroll_runs endpoint.

employee_idstring required

Employee id (participant of the payroll run), refers to employees/employees endpoint.

concept_idstring required

Payroll concept id, refers to compensations/concepts endpoint.

amountinteger

Amount value (nullable; required when is_overwritten=true)

is_overwrittenboolean required

When true, the provided amount becomes amount_overwritten

strategy_type'compensations_fixed_amount_strategy' | 'compensations_variable_amount_strategy' | 'compensations_per_worked_day_amount_strategy'

Amount strategy discriminator

unit_symbolstring

Unit symbol (e.g. EUR)

upper_limitinteger

Upper limit for variable strategy (ignored for fixed / per_worked_day)

per_day_rateinteger

Per-day rate (only used for per_worked_day strategy)

Example request

{
  "payroll_run_id": "1",
  "employee_id": "1",
  "concept_id": "1",
  "amount": 12300,
  "is_overwritten": true,
  "strategy_type": "compensations_variable_amount_strategy",
  "unit_symbol": "EUR"
}

Response

CREATED

idstring required

Employee compensation id

payroll_run_employee_idstring required

Employee id (participant of the payroll run)

payroll_concept_idstring required

Payroll concept id

payroll_run_idstring required

Parent payroll run id

amount_strategy_type'compensations_fixed_amount_strategy' | 'compensations_variable_amount_strategy' | 'compensations_per_worked_day_amount_strategy' required

Amount strategy discriminator

amountinteger

Effective compensation value — the manual override when amount_is_overwritten is true, otherwise the strategy-computed value

amount_is_overwrittenboolean required

Whether the amount is a manual override

result_type'compensation' | 'payroll_result'

Record projection type (always compensation on this endpoint)

source_type'compensations_compensationpolicy' | 'timesettings_customtimerangecategory' | 'expenses_expensable' | 'expenses_expense' | 'expenses_mileage' | 'benefits_compensation' | 'salary_advance_request' | 'incentives_compensationplanrequest' | 'attendance_review'

Source type discriminator (nullable — dashboard-created records have no source)

source_idstring

Source id (nullable — dashboard-created records have no source)

created_by_employee_idstring

Employee id of the author (nullable)

last_updated_by_employee_idstring

Employee id of the last updater (nullable)

created_atstring required

Timestamp when the compensation record was created

updated_atstring required

Timestamp when the compensation record was last updated

Example response

{
  "id": "1",
  "payroll_run_employee_id": "1",
  "payroll_concept_id": "1",
  "payroll_run_id": "1",
  "amount_strategy_type": "compensations_fixed_amount_strategy",
  "amount": 12300,
  "result_type": "compensation",
  "source_type": "expenses_expense",
  "source_id": "42",
  "created_by_employee_id": "1",
  "last_updated_by_employee_id": "1",
  "created_at": "2026-01-01T08:00:00.000Z",
  "updated_at": "2026-01-01T08:00:00.000Z"
}

Changes