---
title: "Creates a Compensation"
method: POST
path: "/api/2026-07-01/resources/contracts/compensations"
tags: ["Contracts > Compensation"]
---

# Creates a Compensation

`POST /api/2026-07-01/resources/contracts/compensations`

Creates a Compensation

## Request body

- object
  - `contract_version_id` string, required
  - `contracts_taxonomy_id` string, required
  - `description` string
  - `compensation_type` string
  - `amount` integer
  - `unit` string
  - `sync_with_supplements` boolean
  - `payroll_policy_id` string
  - `recurrence_count` integer
  - `starts_on` string
  - `recurrence` string
  - `first_payment_on` string
  - `calculation` string
  - `time_condition` 'full_day' | 'half_day' | 'custom'
  - `minimum_amount_of_hours` integer
  - `minimum_amount_of_hours_in_cents` integer

## Response `201`

CREATED

- ContractsCompensation
  - `id` string, required
  - `contract_version_id` string, required
  - `contracts_taxonomy_id` string, required
  - `description` string
  - `compensation_type` string — Required field. You can only use the following options: fixed, undefined, up_to, per_worked_day, per_worked_hour
  - `amount` integer — Value paid on each recurrence, stored in the smallest currency unit (for example cents). Required unless the compensation type is `undefined`
  - `unit` string, required — In which unit compensation is paid
  - `sync_with_supplements` boolean
  - `payroll_policy_id` string
  - `recurrence_count` integer — How much time will pass between payments. If recurrence is empty, assume months. For example, 12 here means compensation is paid yearly
  - `starts_on` string
  - `recurrence` string — Frequency (monthly, yearly, one_time) to determine how often the employee is paid. Could be empty, use `recurrence_count` in that case
  - `first_payment_on` string — Date of the first payout; differs from `starts_on` when payroll scheduling or accrual rules delay payment
  - `calculation` string — Human-readable hint about the payroll formula used (for example "current period" or "average of last 3 months")
  - `currency` string
  - `time_condition` 'full_day' | 'half_day' | 'custom'
  - `minimum_amount_of_hours` integer
  - `minimum_amount_of_hours_in_cents` integer — Compensation expected minimum amount of hours in cents

---

[API](https://skmtc.net/factorialhr/apis/factorial-api.md) · [All operations](https://skmtc.net/factorialhr/apis/factorial-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/factorialhr/factorial-api/revisions/1a6bffb20f7d/schema)