---
title: "Create holiday (deprecated)"
method: POST
path: "/holidays-core/v2/holiday"
tags: ["Holidays v2 - Transaction banking (deprecated)"]
deprecated: true
---

# Create holiday (deprecated)

`POST /holidays-core/v2/holiday`

> **Deprecated.**

**DEPRECATED**. Call the [Add holiday](https://developers.pismo.io/pismo-docs/reference/post-add-holiday-to-calendar) endpoint instead.

This endpoint is deprecated starting April 30, 2026, and final removal from both test (EXT) and production environments on October 30, 2026.

Create a holiday—a day on which your company's offices are closed for normal business activity though online financial transactions and other business activity could still be occurring. 

**Note:** This endpoint is designed for transaction banking. For more information, refer to [Calendars and holidays in transaction banking](https://developers.pismo.io/pismo-docs/docs/calendars-and-holidays-in-transaction-banking).

## Request body

- PresenterCreateHolidayRequestV2 — Create holiday for transaction banking payload
  - `name` string, required — Holiday name
  - `holiday_date` string, required — Holiday date. Format = yyyy-mm-dd.
  - `description` string — Holiday description
  - `administrative_division_id` integer — Administrative division ID. When passed as a parameter, either this or `external_id` is **REQUIRED**. **Note:** Holiday metadata always takes precedence over the administrative division settings. If a holiday is not specifically configured using the [transaction banking parameters](https://developers.pismo.io/pismo-docs/docs/posting-transactions-on-holidays#parameters), the platform defaults to the settings in the administrative division's `metadata` object when processing transactions.
  - `external_id` string — Existing ID value from another process or application. When passed as a parameter, either this or `administrative_division_id` is **REQUIRED**.
  - `metadata` MetadataV2 — A valid JSON schema, as specified in https://json-schema.org/specification.html. Used to register the rules that are used to authorize the transaction. You can use metadata <a href="https://developers.pismo.io/pismo-docs/docs/posting-transactions-on-holidays#parameters">parameters</a> to specify holiday business rules. For details, refer to <a href="https://developers.pismo.io/pismo-docs/docs/posting-transactions-on-holidays">Posting Transactions on Holidays</a>. **Note**: This field must not be used to send Personally Identifiable Information (PII), Payment Card Industry (PCI) data, or any sensitive/regulated information. Metadata fields are intended for operational, non-sensitive data only. For sensitive data, use the specific parameters designed for that purpose. For more information, refer to [Get started with Pismo APIs](https://developers.pismo.io/pismo-docs/reference/get-started-with-pismo-apis#metadata).

## Response `201`

Holidays response

- PresenterCreateHolidayResponseV2
  - `id` integer — Holiday ID
  - `name` string — Holiday name
  - `description` string — Holiday description
  - `holiday_date` string — Holiday date. Format = yyyy-mm-dd.
  - `next_business_date` string, date — Next work day following the holiday. Format = yyyy-mm-dd.
  - `administrative_division_id` integer — Administrative division ID. When passed as a parameter, either this or `external_id` is **REQUIRED**.
  - `metadata` string — Any data object with key/value pairs. No limit on length. **Note**: This field must not be used to send Personally Identifiable Information (PII), Payment Card Industry (PCI) data, or any sensitive/regulated information. Metadata fields are intended for operational, non-sensitive data only. For sensitive data, use the specific parameters designed for that purpose. For more information, refer to [Get started with Pismo APIs](https://developers.pismo.io/pismo-docs/reference/get-started-with-pismo-apis#metadata).

## Other responses

- `400` — Bad request
- `401` — Access token is missing or invalid
- `404` — Not Found
- `500` — Internal server error

---

[API](https://skmtc.net/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.net/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pismo/platform-authentication/revisions/935b62e16de4/schema)