---
search:
  tags:
    - holidays
    - POST
seo:
  description: >-
    Adds a new holiday day to a custom holiday year configuration. Reference for
    the POST /holidays/days endpoint in the Leadtime Public API API.
sidebar:
  badge: POST
  label: Add holiday day
title: Add holiday day
type: openapi-operation
---
Adds a new holiday day to a custom holiday year configuration.

**What this does:**
Creates a new holiday in a custom holiday year. This allows you to add company-specific holidays that don't exist in the default holiday data (e.g., "Company Outing", "Festivus", "Team Building Day").

**Holiday types:**
Only **Fixed** holidays can be created via this endpoint:
- **Fixed**: A specific date that doesn't change (e.g., "2024-12-25" for Christmas)
- **Rule-based**: Holidays computed from rules (e.g., "25 december", "easter monday") come from default definitions
  - Rule-based holidays can only be edited, not created
  - They exist in default holiday configurations and can be modified in custom years

**Requirements:**
- The `yearId` must belong to a custom holiday year (created via `POST /holidays/years`)
- You cannot add holidays to default years - create a custom year first
- The `date` must be in ISO 8601 format (e.g., "2024-12-25")
- The `name` should be descriptive (e.g., "Company Foundation Day")

**Use cases:**
- Adding company-specific holidays
- Adding regional holidays not in the default data
- Creating special event days that should be treated as holidays

**Example:**
To add "Company Outing" on June 15, 2024:
```json
{
  "yearId": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Company Outing",
  "type": "Fixed",
  "date": "2024-06-15"
}
```

<Operation source="api-reference" id="holidayscontroller-createholidayday" />