Webhook Integration

Enabling the Webhook Integration allows absentify to call a script on your server when one or more events happen in the absentify system. Webhooks can be thought of as event listeners or push notifications. They allow you to build or set up integrations, which subscribe to certain events on absentify. When one of those events is triggered, we'll send an HTTP POST payload to the webhook's configured URL. Webhooks can be used to update an external system or even send alerts to your email address.

Configuring webhooks can be done through the absentify Settings page. Simply log in as an admin, click on settings in the top header bar, then click on Webhooks.

Webhook Response

When absentify triggers a webhook URL on your site, it will send data in the following format:

{
   "body":{
      "id":"a2032774-7d41-4820-8858-0e0ec37e64d3",
      "createdAt":"2023-02-10T21:29:32.774Z",
      "updatedAt":"2023-02-10T21:29:32.772Z",
      "start":"2023-02-13T00:00:00.000Z",
      "start_at":"afternoon",
      "end":"2023-02-13T00:00:00.000Z",
      "end_at":"end_of_day",
      "duration":0.5,
      "year":2023,
      "details":{
         "status":"APPROVED",
         "deducted":0.5,
         "reason":"",
         "approval_process":"Linear_all_have_to_agree",
         "request_approvers":[
            {
               "id":283860,
               "approver_member":{
                  "email":"sample@user.com",
                  "name":"Sample User",
                  "id":"c67c0681-db0b-4bc5-8759-020643f618b0",
                  "custom_id":""
               },
               "reason":null,
               "status":"APPROVED",
               "status_change_date":null,
               "predecessor_request_approver_id":null
            }
         ],
         "requester_member":{
            "email":"sample@user.com",
            "name":"Sample User",
            "id":"c67c0681-db0b-4bc5-8759-020643f618b0",
            "custom_id":"",
            "allowances":[
               {
                  "allowance":30,
                  "brought_forward":10.5,
                  "compensatory_time_off":0,
                  "remaining":38.5,
                  "taken":2,
                  "year":2023
               },
               {
                  "allowance":30,
                  "brought_forward":14.5,
                  "compensatory_time_off":0,
                  "remaining":10.5,
                  "taken":34,
                  "year":2022
               },
               {
                  "allowance":30,
                  "brought_forward":38.5,
                  "compensatory_time_off":0,
                  "remaining":68.5,
                  "taken":0,
                  "year":2024
               },
               {
                  "allowance":14.5,
                  "brought_forward":0,
                  "compensatory_time_off":0,
                  "remaining":14.5,
                  "taken":0,
                  "year":2021
               }
            ]
         },
         "leave_type":{
            "id":"b9362b30-251d-4ba8-929b-181d9afcc924",
            "name":"Holiday"
         },
         "cancel_reason":null,
         "canceld_date":null,
         "canceld_by_member":null
      }
   }
}

Updated on: 14/03/2023