Skip to main content
PUT
/
holiday-calendars
/
{id}
Update a holiday calendar
curl --request PUT \
  --url https://api.reply.io/v3/holiday-calendars/{id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --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

X-API-Key
string
header
required

API key passed in the X-API-Key header

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
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