---
title: "Add & Update Salary"
method: POST
path: "/hr/salary"
---

# Add & Update Salary

`POST /hr/salary`

## Request body

- object
  - `gid` string — Reference code of the employee. This is generated when the employee is added to the system and is used to link salary details with that employee.
  - `effectivedate` string, date — The date (YYYY-MM-DD) from which this salary structure becomes effective.
  - `basic` number, double — The basic salary of the employee.
  - `taxable_benefits` object[] — Components of salary that are taxable allowances
    - `Hra` object[] — Allowance given to employees for rental expenses.
      - `amount` number, double — Amount assigned to the benefit.
      - `type` 'Fixed-Standard' | 'Fixed-Prorated' — Benefit type
    - `MedicalAllowance` object[] — Fixed monthly medical allowance provided as part of salary.
      - `amount` number, double — Amount assigned to the benefit.
      - `type` 'Fixed-Standard' | 'Fixed-Prorated' — Benefit type
    - `ConveyanceAllowance` object[] — Allowance for travel/transport expenses.
      - `amount` number, double — Amount assigned to the benefit.
      - `type` 'Fixed-Standard' | 'Fixed-Prorated' — Benefit type
    - `SpecialAllowance` object[] — A flexible component of salary, usually adjusted to balance the total cost-to-company (CTC) after assigning other fixed allowances.
      - `amount` number, double — Amount assigned to the benefit.
      - `type` 'Fixed-Standard' | 'Fixed-Prorated' — Benefit type
    - `OtherAllowance` object[] — A general-purpose allowance provided to employees which does not fall under any specific predefined category.
      - `amount` number, double — Amount assigned to the benefit.
      - `type` 'Fixed-Standard' | 'Fixed-Prorated' — Benefit type
    - `CityCompensatoryAllowance` object[] — Paid to employees working in metro or high-cost cities to compensate for higher living expenses.
      - `amount` number, double — Amount assigned to the benefit.
      - `type` 'Fixed-Standard' | 'Fixed-Prorated' — Benefit type
    - `MobileAllowance` object[] — Reimbursement or fixed allowance for official mobile/telephone expenses.
      - `amount` number, double — Amount assigned to the benefit.
      - `type` 'Fixed-Standard' | 'Fixed-Prorated' — Benefit type
    - `RM_ChildrenEducationAllowance` object[] — Allowance provided for supporting children’s education expenses.
      - `amount` number, double — Amount assigned to the benefit.
      - `type` 'Fixed-Standard' | 'Fixed-Prorated' — Benefit type
    - `RM_HostelAllowance` object[] — Allowance granted for children’s hostel accommodation expenses.
      - `amount` number, double — Amount assigned to the benefit.
      - `type` 'Fixed-Standard' | 'Fixed-Prorated' — Benefit type
    - `RM_LeaveTravelAllowance` object[] — Allowance to cover travel expenses incurred during official leave, often exempt under tax rules if conditions are met.
      - `amount` number, double — Amount assigned to the benefit.
      - `type` 'Fixed-Standard' | 'Fixed-Prorated' — Benefit type
    - `PerformanceAllowance` unknown[] — Allowance linked to employee performance, typically based on appraisal outcomes or incentives.
      - unknown
    - `RM_UniformAllowance` object[] — Allowance provided to employees for purchasing or maintaining uniforms required for work.
      - `amount` number, double — Amount assigned to the benefit.
      - `type` 'Fixed-Standard' | 'Fixed-Prorated' — Benefit type
  - `Reimbursement` object[] — Reimbursements provided to employees for official purposes
    - `FuelAndMaintenanceReimbursement` number, double — Reimbursement for fuel and vehicle maintenance expenses incurred for official purposes.
    - `DriverSalaryReimbursement` number, double — Reimbursement of driver salary expenses if a driver is employed for official duty.
    - `MobileReimbursement` number, double — Reimbursement of mobile/telephone expenses used for business communication.
    - `InternetReimbursement` number, double — Reimbursement of internet expenses used for official work purposes.
  - `Deductions` object[] — Salary components deducted from the employee’s
    - `Penalty` number, double — Deduction amount applied for that employee.
  - `retirement_benefits` object[] — Contributions and eligibility details related to retirement and statutory benefits:
    - `pf_percentage` '12-Basic' | '12-Gross' | 'NO' — 12-Basic → PF calculated as 12% of Basic salary. 12-Gross → PF calculated as 12% of Gross salary. NO → PF not applicable
    - `PF_Type` 'YES' | 'NO' — Specifies whether Provident Fund (PF) deduction is capped or not. YES → PF amount will be capped at ₹1800 maximum (even if calculated PF exceeds this). NO → No capping is applied. PF will be calculated as per pf_percentage (e.g., 12% of Basic or Gross).
    - `esi_eligible` 'YES' | 'NO' — Employee State Insurance applicability

## Response `200`

200

- object

## Other responses

- `400` — 400

---

[API](https://skmtc.net/ledgers/apis/authentication.md) · [All operations](https://skmtc.net/ledgers/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ledgers/authentication/versions/605f28ef08ef/schema)