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/settingsAuthorization
AuthorizationOAuth2 access token · headerrequiredScopes:
api:writeor
AuthorizationBearer token (JWT) · headerrequiredRequest body
requiredapplication/jsondefaultHolidayCodestringrequiredThe 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"
}'const response = await fetch("https://leadtime.app/api/public/holidays/settings", {
method: "PUT",
headers: {
"Authorization": "Bearer YOUR_ACCESS_TOKEN",
"Content-Type": "application/json"
},
body: JSON.stringify({
"defaultHolidayCode": "US"
})
});import requests
response = requests.put(
"https://leadtime.app/api/public/holidays/settings",
headers={
"Authorization": "Bearer YOUR_ACCESS_TOKEN",
"Content-Type": "application/json"
},
json={
"defaultHolidayCode": "US"
},
)Response
Holiday settings updated successfully
Unauthorized - Invalid or missing authentication token
Forbidden - Insufficient API scopes or permissions