Skip to main content
POST
/
v3
/
holiday-calendars
Create a holiday calendar
curl --request POST \
  --url https://api.reply.io/v3/holiday-calendars \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --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

​
Authorization
string
header
required

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

Authorization: Bearer <your-api-key>

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