Webhooks

Webhook is a simple and effective communication mechanism that allows you to share data with other applications in real time. The data is delivered immediately after the event is executed, without need to frequently query the application via API.

Outgoing webhook

In Unrubble you can define webhooks for three events:

New time off request
Accepted time off request modified
Accepted time off request deleted

Adding a webhook

Go to Settings (by clicking on the account icon) > Integrations tab and press the green Configuration button in the Webhook integration.

Configuration

Type - Select from the list the event for which you want to define the webhook,
Add your own URL,
Define a Token (optional).

The token used for authorization is optional. If it is entered, it will be included in the request in the form of a "token" header.

If the two-step acceptance of leave requests in Unrubble is enabled, the event will be sent only after full acceptance (2 people).

Sending

Webhooks are sent when:
✅ The time off request is accepted
✅ The time off request is edited and saved
✅ The approved time off request will be deleted
❌ The time off request will be added
❌ A time off request that is not accepted will be deleted
❌ The time off request will be approved by one of the two

Webhook format for an approved vacation request and a modified one:

{
    "applicationNumber": "2020/1",
    "applicationType": "Paid time off",
    "acronym": "123",
    "applicantFullName": "Name and Surname",
    "startDateTimeUtc": "1600034400",
    "endDateTimeUtc": "1600552800",
    "ignoreWeekends": "true",
    "ignoreHolidays": "true",
    "isWholeDay": "true",
    "note": "Note"
}

Webhook format for deleted accepted application:

{
    "applicationNumber": "2020/1"
}

Updated on: 12/06/2024