Create a business calendar Reference Published Oct 13, 2026 Create a business calendar in Dynatrace with the Automation API, including title, weekstart, holidays, validFrom, validTo, description, and weekdays.
POST SaaS https://{your-environment-id}.apps.dynatrace.com/platform/automation/v1/business-calendars
Overview You send a request body with fields such as id, title, weekstart, holidays, validFrom, validTo, description, and weekdays. Dynatrace returns the created business calendar from the Automation API.
Authentication To execute this request, you need a platform token or OAuth access token with automation:calendars:write scope. To learn how to obtain and use it, see Tokens and authentication .
Parameters Request body objects The BusinessCalendarCreate object id string - Optional title string - Required weekstart integer - Optional holidays Holiday - Optional validFrom string - Optional validTo string - Optional description string - Optional weekdays Weekdays | Weekdays - Optional
The Holidays object The Holiday object title string - Required date string - Required
The Weekdays object
The WeekdaysNames object
The WeekdaysValues object Request body JSON model This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.
{
"id" : "string" ,
"title" : "string" ,
"weekstart" : 1 ,
"holidays" : [
{
"title" : "string" ,
"date" : "string"
}
] ,
"validFrom" : "string" ,
"validTo" : "string" ,
"description" : "string" ,
"weekdays" : [
"MO" ,
"TU" ,
"WE" ,
"TH" ,
"FR"
]
}
Response Response body objects The BusinessCalendarResponse object
The Holidays object The ModificationInfo object createdBy string - createdTime string - lastModifiedBy string - lastModifiedTime string -
The WeekdaysValues object
The WeekdaysNames object The ErrorDetails object errorCode string - errorRef string -
Response body JSON models {
"id" : "string" ,
"title" : "string" ,
"version" : 1 ,
"weekstart" : 1 ,
"holidays" : [
{
"title" : "string" ,
"date" : "string"
}
] ,
"validFrom" : "string" ,
"validTo" : "string" ,
"description" : "string" ,
"modificationInfo" : {
"createdBy" : "string" ,
"createdTime" : "string" ,
"lastModifiedBy" : "string" ,
"lastModifiedTime" : "string"
} ,
"weekdays" : [
1 ,
2 ,
3 ,
4 ,
5
] ,
"weekdaysNames" : [
"MO" ,
"TU" ,
"WE" ,
"TH" ,
"FR"
]
}
{
"error" : {
"message" : "string" ,
"code" : 1 ,
"details" : {
"errorCode" : "string" ,
"errorRef" : "string"
}
}
}