Skip to main content
POST
/
holiday-calendars
Create a holiday calendar
curl --request POST \
  --url https://api.reply.io/v3/holiday-calendars \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "name": "Company Holidays 2026",
  "repeatEveryYear": false,
  "holidays": [
    {
      "startDate": "2026-07-04",
      "endDate": "2026-07-04",
      "name": "Independence Day"
    },
    {
      "startDate": "2026-12-24",
      "endDate": "2026-12-26",
      "name": "Christmas Break"
    }
  ]
}
'
{
  "id": 3,
  "name": "US Holidays",
  "calendarType": "custom",
  "countryCode": "US",
  "repeatEveryYear": true,
  "holidays": [
    {
      "id": 100,
      "startDate": "2026-12-25",
      "endDate": "2026-12-25",
      "name": "Christmas Day"
    }
  ]
}

Authorizations

X-API-Key
string
header
required

API key passed in the X-API-Key header

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
required

Unique identifier for the holiday calendar

name
string
required

Name of the holiday calendar

calendarType
string
required

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

countryCode
string
required

ISO 3166-1 alpha-2 country code

repeatEveryYear
boolean

Whether the holidays repeat annually

holidays
Holiday · object[]

List of holidays in this calendar