---
title: "Create a vacation pay setting"
method: POST
path: "/vacation_pay_settings"
tags: ["Vacation Pay Settings"]
---

# Create a vacation pay setting

`POST /vacation_pay_settings`

## Request body

- object
  - `work_assignment_id` string, required
  - `effective_from` string, date, required
  - `effective_to` string, date
  - `percentage` number, required
  - `vacation_pay_method` 'manual' | 'per_period'
  - `overrides` object[]
    - `type` 'allowance' | 'earning' | 'reimbursement'
    - `subtype` string
    - `percentage` number
    - `method` 'manual' | 'per_period'
  - `note` string, nullable

## Response `201`

Created

- object
  - `id` string — The unique identifier of the object in Nmbr.
  - `object` string — The type of the object in Nmbr (`"vacation_pay_setting"`).
  - `data` VacationPaySetting
    - `percentage` number
    - `vacation_pay_method` 'manual' | 'per_period'
    - `effective_from` string, date
    - `effective_to` string, date, nullable
    - `earliest_valid_effective_to` string, date, nullable
    - `is_editable` boolean — When false, only the `effective_to` attribute may be updated.
    - `is_deletable` boolean
    - `work_assignment` object
      - `id` string — The unique identifier of the object in Nmbr.
      - `object` string — The type of the object in Nmbr (`"work_assignment"`).
    - `note` string, nullable
    - `created_at` string, dateTime — The date and time the object was created in Nmbr.
    - `updated_at` string, dateTime — The date and time the object was last updated in Nmbr.

---

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