Q2 2025 Roadmap: Request a beta API key and access upcoming features: Embedded Notifications, Team Communications and more.

Create Policy

POST

/api/organizations/{organization_id}/policies

Creates a new time off policy for an organization.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/organizations//policies' \
--header 'Content-Type: application/json' \
--data-raw ''

Response Example

{}

Request

Path Params

organization_id

string

required

Body Params application/json

name

string

required

The name of the policy

typeId

string

required

The type of the policy

paid

boolean

required

Whether the policy is paid

units

enum<string>

required

The units of the policy

Allowed values:

dayshours

limitSettings

object

required

The limit settings of the policy

isFixedAmount

boolean

required

Whether the limit settings are fixed amount

fixedAmount

object

required

The fixed amount

requiresApproval

boolean

required

Whether the policy requires approval

carryover

boolean

required

Whether the policy allows carryover

allowNegativeBalance

boolean

required

Whether the policy allows negative balance

default

boolean

required

Whether the policy is default

fullDayDuration

number

required

The full day duration of the policy

workerPolicies

array[object (NewWorkerPolicyDto) {3}]

required

The worker policies of the policy

workerId

string

required

The worker id of the policy

hoursBalance

number

required

The hours balance of the policy

isIncluded

boolean

required

Whether the policy is included

Examples

Responses

🟢201Created

application/json

Body

object {0}

List all policy types

Update Policy