---
title: "Create a new holiday for current user"
method: POST
path: "/user/holidays"
tags: ["User"]
---

# Create a new holiday for current user

`POST /user/holidays`

Create a new holiday for current user.

## Request body

- object
  - `name` string, required — The name of the holiday.
  - `region` string, required — A valid country code based on iso3166-1 alpha-3 standard. see: https://www.iso.org/iso-3166-country-codes.html
  - `consecutive` boolean, required — Whether the holiday consists of consecutive days.
  - `every_year` boolean, required — Does the holiday take effect every year.
  - `year_start` integer — The start year of holiday.
  - `year_end` integer — The end year of holiday.
  - `month_start` integer — The start month of holiday.
  - `month_end` integer — The end month of holiday.
  - `day_start` integer — The start day of holiday.
  - `day_end` integer — The end day of holiday.
  - `hour_start` integer — The start hour of holiday.
  - `hour_end` integer — The end hour of holiday.
  - `minute_start` integer — The start minute of holiday.
  - `minute_end` integer — The end minute of holiday.

## Response `201`

Created

- object
  - `id` string — The unique ID of the resource.

## Other responses

- `4XX` — Error

---

[API](https://skmtc.net/portsip/apis/portsip-pbx-rest-api.md) · [All operations](https://skmtc.net/portsip/apis/portsip-pbx-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/portsip/portsip-pbx-rest-api/revisions/577415d4a3d5/schema)