Absence webhooks

Receive webhook notifications whenever absences are created, updated, deleted or requests are approved. Absence webhooks can be used to trigger actions in your application whenever an absence is changed, for example to keep an external HR or scheduling system up to date.

Events

Event	Description
absence.created	Occurs whenever an absence is created directly or an absence request is approved.
absence.updated	Occurs whenever any absence's information is updated.
absence.deleted	Occurs whenever an absence is deleted directly or a cancellation request is approved.

Example Payload

We return JSON-formatted content with the following structure.

Name	Example content	Description
type	absence	Resource type
event	absence.created	Event that triggered the webhook, lowercase, dot-separated
url	https://app.freispace.com/staffs/a247dce0-6215-4ca4-bc1c-42a69a078d85/presences/2026	URL to the time tracking overview of the staff member
data	{}	The absence block information

{
    "type": "absence",
    "event": "absence.created",
    "url": "https://app.freispace.com/staffs/a247dce0-6215-4ca4-bc1c-42a69a078d85/presences/2026",
    "data": {
        "staff_id": "a247dce0-6215-4ca4-bc1c-42a69a078d85",
        "absence_type_id": "a247dcde-dbe2-4bae-af3f-b24725d9cf3c", // null if the absence is a holiday/vacation
        "start": "2026-08-06", // First day of the absence block
        "end": "2026-08-06", // Last day of the absence (inclusive)
        "length": 1, // Total length in days
        "is_holiday": false, // Whether the absence is a holiday/vacation
        "comment": null,
        "status": "approved",
        "days": [ // Per-day breakdown of the absence block
            {
                "id": "a24800a6-584c-425c-9ac1-d6bb3d70d0c4",
                "date": "2026-08-06",
                "is_half_day": false,
                "half_day_daytime": null, // "morning" or "afternoon" if this is a half-day absence
                "length": 1 // 0.5 for half-day absences, 1 for full-day absences
            }
        ],
        "created": "2026-07-17T15:15:22+00:00",
        "updated": "2026-07-17T15:15:22+00:00"
    }
}

info

start, end and the entries in days are calendar dates without a time component. The created and updated timestamps are in UTC.