---
title: "Creates a Blocked period"
method: POST
path: "/api/2026-10-01/resources/timeoff/blocked_periods"
tags: ["Timeoff > BlockedPeriod"]
---

# Creates a Blocked period

`POST /api/2026-10-01/resources/timeoff/blocked_periods`

## Request

- Base URL: `https://api.factorialhr.com`
- URL: `https://api.factorialhr.com/api/2026-10-01/resources/timeoff/blocked_periods`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://id.factorialhr.com/oauth/authorize`
    - Token URL: `https://id.factorialhr.com/api/oauth/token` scopes: `time_off`
  - API key in header `x-api-key`

Creates a blocked period is add a range of dates during which employees cannot submit time off requests. This allows to better plan your team's work throughout the year and ensure that time off requests are in line with the company's needs

## Request body

- object
  - `company_id` string, required: The company id
  - `name` string, required: Name of the blocked period.
  - `leave_type_ids` string[], required: An array of leave type identifiers for which employees can not request timeoff

## Response `201`

CREATED

- TimeoffBlockedPeriodsPolicy
  - `id` string, required: Unique identifier of the blocked period
  - `company_id` string, required: Company id of the blocked period
  - `name` string, required: Name of the blocked period.
  - `leave_type_ids` string[], required: Leave types for which absence request has been blocked
  - `time_periods` object[], required: The tenure periods associated with the allowance.
    - `id` string, required
    - `policy_id` string, required
    - `name` string, required
    - `period_type` string, required
    - `start_on` string
    - `finish_on` string
    - `duration` integer
    - `duration_unit` string
  - `strategy` string, required: Type of access group
  - `members` string[], required: Employees whose timeoff will be affected
  - `location_ids` string[]: List of locations workplace identifiers where the employees are located
  - `team_ids` string[]: List of team identifiers which the selected employees belong to
  - `legal_entity_ids` string[]: List of legal entity identifiers which the selected employees belong to

## Changes

- **2026-11-03** `83ac9aa1de50`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/factorialhr/apis/factorial-api/changes/api/2026-10-01/resources/timeoff/blocked_periods/post.md)

---

[API](https://skmtc.dev/factorialhr/apis/factorial-api.md) - [All operations](https://skmtc.dev/factorialhr/apis/factorial-api/llms.txt) - [OpenAPI document](https://skmtc.dev/factorialhr/apis/factorial-api/revisions/83ac9aa1de50?raw)