> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a leave policy

> Create a leave policy in your Plane workspace.

### Parameters

<ParamField body="name" type="string" required>
  Human-readable policy name.
</ParamField>

<ParamField body="description" type="string">
  Plain-language explanation of the policy.
</ParamField>

<ParamField body="status" type="string">
  Lifecycle state for the policy. One of `draft`, `active`, or `archived`. Defaults to `active`.
</ParamField>

<ParamField body="type" type="string" required>
  Leave type, for example `vacation` or `sick_time_off`.
</ParamField>

<ParamField body="effect" type="string" required>
  Whether the policy is a `set` or `add` policy.
</ParamField>

<ParamField body="unit" type="string" required>
  Unit used for policy quantities. One of `days` or `hours`.
</ParamField>

<ParamField body="eligibility" type="string">
  Optional CEL expression used for automatic matching against the worker resource shape, for
  example `worker.employment.location.address.country == "FR"`.
</ParamField>

<ParamField body="period" type="object" required>
  Period definition for the policy.
</ParamField>

<ParamField body="accrual" type="object">
  Optional accrual rule. Use `null` for unlimited leave.
</ParamField>

<ParamField body="carryover" type="object">
  Optional carryover rule. Use `null` for use-it-or-lose-it.
</ParamField>

<ParamField body="balance" type="object">
  Optional balance bounds. Use `null` for unlimited leave.
</ParamField>

<ParamField body="usage" type="object">
  Optional per-period usage cap.
</ParamField>

<ParamField body="payout" type="object" required>
  Termination payout rule.
</ParamField>

### Returns

Returns the created [Leave Policy object](/reference/leave-policies/object).