Creates a new absence.
User planning data permissions are required if the calling user is not the owner of the absence or admin. The startOn and endOn get rounded to 00:00:00, 12:00:00, or 23:59:59 in UTC. These values can be used to set a half-day (pre or post mid-day) absence, or absences that start or end at mid-day. The end date needs to be the same or after the start date.
Subscription Level
This endpoint requires the Standard plan or higher.Headers
Authorization
Bearer authentication of the form Bearer <token>, where token is your auth token.
Request
This endpoint expects an object.
userId
The id of the user to create the absence for.
startOn
The start time of the absence.
The time of the date will be ignored.
endOn
The end time of the absence.
The time of the date will be ignored.
description
The reason for the absence.
isHalfDayOnStart
If it's true and it's a single day absence means that the absence to create is for the first half of the workday.
If it's a multi day absence it started on the second half of the first day of the absence period.
isHalfDayOnEnd
If it's true and it's a single day absence means that the absence to create is for the second half of the workday.
If it's a multi day absence it ended on the first half of the last day of the absence period.
isSingleDayAbsence
Response
OK
id
createdOn
createdBy
updatedOn
updatedBy
userId
The id of the user to create the absence for.
startOn
The start time of the absence.
endOn
The end time of the absence.
description
The reason for the absence.
externalProvider
The external provider for the absence.
deletedOn
The date the absence was deleted.
deletedBy
The id of the user that deleted the absence.
isReadOnly
If it’s true it means that this Absence is read-only and cannot be edited/deleted by the user.
isHalfDayOnStart
If it's true and it's a single day absence means that the absence is for the first half of the workday.
If it's a multi day absence it started on the second half of the first day of the absence period.
isHalfDayOnEnd
If it's true and it's a single day absence means that the absence is for the second half of the workday.
If it's a multi day absence it ended on the first half of the last day of the absence period.