FAfactorialhr
Compensations > AdditionalCompensation

Creates an Additional compensation

Changed on

Creates an additional compensation for a contract version.

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

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/compensations/additional_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

contract_version_idstring required

Target contract version id, refers to contracts/contract_versions endpoint.

payroll_concept_idstring required

Payroll concept id, refers to compensations/concepts endpoint.

amount_strategy_type'contracts_fixed_amount_strategy' | 'contracts_variable_amount_strategy' | 'contracts_per_worked_day_amount_strategy' required

Amount strategy discriminator

amountinteger

Amount value (required for Fixed and PerWorkedDay strategies)

upper_limitinteger

Upper limit for Variable strategy (ignored for others)

descriptionstring

Free-text description

recurrence'monthly' | 'every_2_months' | 'every_3_months' | 'every_4_months' | 'every_5_months' | 'every_6_months' | 'every_7_months' | 'every_8_months' | 'every_9_months' | 'every_10_months' | 'every_11_months' | 'every_12_months'

Recurrence label. One of monthly, every_2_months, every_3_months, every_4_months, every_5_months, every_6_months, every_7_months, every_8_months, every_9_months, every_10_months, every_11_months, every_12_months.

first_payment_onstring

Date of the first payment (must be on or after the contract version's effective month)

Example request

{
  "contract_version_id": "10",
  "payroll_concept_id": "20",
  "amount_strategy_type": "contracts_fixed_amount_strategy",
  "amount": 12300,
  "description": "Performance bonus",
  "recurrence": "monthly",
  "first_payment_on": "2026-02-01"
}

Response

CREATED

idstring required

The identifier of the additional compensation

contract_version_idstring required

Contract version this additional compensation is attached to

company_idstring required

Company id

payroll_concept_idstring required

Payroll concept classifying this additional compensation

employee_idstring required

Employee id derived from the contract version

recurrencestring

Recurrence label. One of monthly, every_2_months, every_3_months, every_4_months, every_5_months, every_6_months, every_7_months, every_8_months, every_9_months, every_10_months, every_11_months, every_12_months.

first_payment_onstring

Date of the first payment

descriptionstring

Free-text description

amount_strategy_type'contracts_fixed_amount_strategy' | 'contracts_variable_amount_strategy' | 'contracts_per_worked_day_amount_strategy' required

Amount strategy discriminator — one of contracts_fixed_amount_strategy, contracts_variable_amount_strategy, contracts_per_worked_day_amount_strategy

amount_strategy_idstring required

Amount strategy id

amountinteger

Amount value (Fixed / PerWorkedDay strategies)

upper_limitinteger

Upper limit (Variable strategy only)

created_atstring required

Timestamp when the additional compensation was created

updated_atstring required

Timestamp when the additional compensation was last updated

Example response

{
  "id": "1",
  "contract_version_id": "10",
  "company_id": "1",
  "payroll_concept_id": "20",
  "employee_id": "5",
  "recurrence": "monthly",
  "first_payment_on": "2026-02-01",
  "description": "Performance bonus",
  "amount_strategy_type": "contracts_fixed_amount_strategy",
  "amount_strategy_id": "30",
  "amount": 12300,
  "created_at": "2026-01-01T08:00:00.000Z",
  "updated_at": "2026-01-01T08:00:00.000Z"
}

Changes