Skip to content
Leadtime
English
Esc
navigateopen⌘Jpreview

Update holiday settings

Updates the default holiday country/region code for the workspace.

What this does: Sets the default holiday source that will be automatically applied to all new employees. This ensures consistent holiday rules across your workspace while still allowing individual customization.

Important:

  • This only affects new employees - existing employees keep their current holiday settings
  • The country code must be one of the available codes from GET /holidays/countries
  • Examples: “US” (United States), “DE” (Germany), “US-CA” (California), “AT” (Austria)

Use cases:

  • Setting up a new workspace with a primary location
  • Changing the default for a workspace that has moved or expanded to a new region
  • Standardizing holiday rules across the organization
PUT/holidays/settings
Authorization
AuthorizationOAuth2 access token · headerrequired
Scopes:api:write
or
AuthorizationBearer token (JWT) · headerrequired
Request body
requiredapplication/json
defaultHolidayCodestringrequired
The default holiday country/region code to set for the workspace. Must be one of the available codes from `GET /holidays/countries`. Examples: "US" (United States), "DE" (Germany), "US-CA" (California), "AT" (Austria). This setting only affects new employees - existing employees keep their current holiday settings.
Responses
200Holiday settings updated successfully
401Unauthorized - Invalid or missing authentication token
403Forbidden - Insufficient API scopes or permissions
Request
curl -X PUT "https://leadtime.app/api/public/holidays/settings" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "defaultHolidayCode": "US"
}'
Response
Holiday settings updated successfully