---
title: "Creates a new balance assignment for a user in policy"
method: POST
path: "/v1/workspaces/{workspaceId}/time-off/balance/assignment"
tags: ["Balance Assignment"]
---

# Creates a new balance assignment for a user in policy

`POST /v1/workspaces/{workspaceId}/time-off/balance/assignment`

## Path parameters

- `workspaceId` string, required — Represents workspace identifier across the system.

## Request body

- CreateBalanceAssignmentV1Request
  - `balance` number, double, required — Represents the amount of balance to be created
  - `dateRange` DateRangeV1Request — Represents the date range when the new balance will be usable. If null, this will default to the current day until the same day next year.
    - `end` string — Provide end date in YYYY-MM-DD format.
    - `start` string — Provide start date in YYYY-MM-DD format.
  - `note` string — Represents note attached to updating balance.
  - `policyId` string, required — Represents the identifier of the policy where the balance assignment will be created
  - `userIds` string[], required — Represents list of users' identifiers whose balance is to be updated.

## Response `201`

Created

---

[API](https://skmtc.dev/clockify/apis/clockify-api.md) · [All operations](https://skmtc.dev/clockify/apis/clockify-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clockify/clockify-api/revisions/a5b636acbcd8/schema)