Skip to main content
POST
Create a holiday calendar

Authorizations

Authorization
string
header
required

Authenticate every request with a Bearer token. Pass your Reply API key in the Authorization header:

Get your API key from the Reply dashboard: Settings → API Key.

Body

application/json

Request body for creating a new custom holiday calendar.

name
string
required

Name of the holiday calendar

repeatEveryYear
boolean

Whether the holidays should repeat annually

holidays
HolidayInput · object[]

List of holidays to include in the calendar

Response

Holiday calendar created successfully

Full representation of a holiday calendar including individual holidays.

id
integer
read-only

Unique identifier for the holiday calendar

name
string

Name of the holiday calendar

calendarType
string

Type of calendar (e.g., "predefined", "custom")

countryCode
string

ISO 3166-1 alpha-2 country code

repeatEveryYear
boolean

Whether the holidays repeat annually

holidays
Holiday · object[]

List of holidays in this calendar