Skip to main content
PUT
/
v3
/
holiday-calendars
/
{id}
Update a holiday calendar
curl --request PUT \
  --url https://api.reply.io/v3/holiday-calendars/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Company Holidays 2026 (Updated)",
  "repeatEveryYear": true,
  "holidays": [
    {
      "startDate": "2026-07-04",
      "endDate": "2026-07-04",
      "name": "Independence Day"
    }
  ]
}
'
{
  "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.

Path Parameters

​
id
integer
required

Holiday calendar ID

Body

application/json

Request body for updating an existing 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 (replaces all existing holidays)

Response

Holiday calendar updated 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