absentify (Preview)
absentify is a comprehensive absence management solution designed for Microsoft 365. This connector enables seamless integration, allowing you to automate workflows based on employee leave requests, track approval statuses, and synchronize absence data across your business systems.
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
| Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | absentify Support |
| URL | https://absentify.com/docs |
| support@absentify.com |
| Connector Metadata | |
|---|---|
| Publisher | BrainCore Solutions |
| Website | https://absentify.com |
| Privacy policy | https://absentify.com/privacy-policy |
| Categories | Human Resources;Business Management |
absentify
absentify is a free tool specifically designed for the Microsoft 365 environment to efficiently manage your team's or employees' absences. It provides a comprehensive overview of all time off and the reasons given, eliminating the need for cumbersome Excel sheets. absentify offers the easiest way to approve vacation requests and holidays, fully integrated with Microsoft Teams and Microsoft 365.
Publisher: BrainCore Solutions GmbH
Prerequisites
To use this connector, you need a work, school, or personal Microsoft account. You must also accept the permissions and consent for absentify by following one of these steps:
- Teams: Install the absentify Teams app, launch it, and accept the permissions and consent.
- Web: Open the absentify web app and accept the permissions and consent.
Additionally, you need the Essentials Plan or higher to use the triggers of this connector.
Supported Operations
The connector supports the following operations:
Triggers
When a leave request is created
This trigger is activated when a new request is created in your company.
When a leave request status changes
This trigger is activated when the status of an existing request changes.
API Operations (Plus Plan required)
The following operations require the absentify Plus plan:
Members
[Plus] Get all members- Retrieve all members with optional filters for departments, status, employment dates, and more.[Plus] Invite a member- Invite a new member to the workspace.[Plus] Get member by ID- Retrieve a specific member by their unique ID.[Plus] Update a member- Update an existing member's information.[Plus] Delete a member- Delete a member permanently.[Plus] Get member by Microsoft ID- Retrieve a member by their Microsoft user ID.[Plus] Get member by email- Retrieve a member by their email address.[Plus] Get member by custom ID- Retrieve a member by their custom ID.[Plus] Update member approvers- Update the approvers for a specific member.[Plus] Update member allowance- Update a member's allowance for a specific year.[Plus] Add member schedule- Add a new work schedule for a member.
Departments
[Plus] Get all departments- Retrieve all departments in the workspace.[Plus] Create a department- Create a new department.[Plus] Update a department- Update an existing department.[Plus] Delete a department- Delete a department.
Leave Types
[Plus] Get all leave types- Retrieve all leave types configured in the workspace.[Plus] Create a leave type- Create a new leave type.[Plus] Update a leave type- Update an existing leave type.[Plus] Delete a leave type- Delete a leave type.
Requests
[Plus] Get all requests- Retrieve all leave requests with optional filters.[Plus] Create a request- Create a new leave request for a member.[Plus] Get request by ID- Retrieve a specific leave request by its ID.[Plus] Update a request- Update the status of a leave request (approve, decline, or cancel).[Plus] Delete a request- Delete a leave request permanently.
Public Holidays
[Plus] Get all public holiday calendars- Retrieve all public holiday calendars.[Plus] Create a public holiday calendar- Create a new public holiday calendar.[Plus] Get public holiday calendar by ID- Retrieve a specific calendar with all its holidays.[Plus] Update a public holiday calendar- Update an existing calendar.[Plus] Delete a public holiday calendar- Delete a calendar.
Workspace
[Plus] Get workspace settings- Retrieve the workspace settings and configuration.
Absences
[Plus] Get absences- Retrieve absences for a specific date range.
Obtaining Credentials
To use this connector, you need a work, school, or personal Microsoft account, which you can log in with directly.
Getting Started
Install absentify through one of the following methods:
- Teams: Install the absentify Teams app, launch it, and accept the permissions and consent.
- Web: Open the absentify web app and accept the permissions and consent.
To fully configure your account, follow this quickstart guide. Ensure you are on the Essentials Plan or higher for triggers, or Plus Plan for API operations.
You're now ready to get started.
Known Issues and Limitations
- In the Essentials Plan, you can only create three triggers. After the third trigger, you will receive an error message and need to delete an existing trigger before creating a new one.
- API operations (marked with [Plus]) require the absentify Plus plan. If you attempt to use these operations without the Plus plan, you will receive an error.
Deployment Instructions
Please follow these instructions to deploy this connector as a custom connector in Microsoft Power Automate and Power Apps.
Creating a connection
The connector supports the following authentication types:
| OAuth Connection | OAuth Connection | All regions | Not shareable |
| Default [DEPRECATED] | This option is only for older connections without an explicit authentication type, and is only provided for backward compatibility. | All regions | Not shareable |
OAuth Connection
Auth ID: undefined
Applicable: All regions
OAuth Connection
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
Default [DEPRECATED]
Applicable: All regions
This option is only for older connections without an explicit authentication type, and is only provided for backward compatibility.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
Actions
| [Plus] Add member schedule |
Add a new work schedule for a member. Requires absentify Plus plan. |
| [Plus] Create a department |
Create a new department in the workspace. Requires absentify Plus plan. |
| [Plus] Create a leave type |
Create a new leave type in the workspace. Requires absentify Plus plan. |
| [Plus] Create a public holiday calendar |
Create a new public holiday calendar in the workspace. Requires absentify Plus plan. |
| [Plus] Create a request |
Create a new leave request for a member. Requires absentify Plus plan. |
| [Plus] Delete a department |
Delete a department from the workspace. Requires absentify Plus plan. |
| [Plus] Delete a leave type |
Delete a leave type from the workspace. Requires absentify Plus plan. |
| [Plus] Delete a member |
Delete a member. All data will be deleted permanently. Requires absentify Plus plan. |
| [Plus] Delete a public holiday calendar |
Delete a public holiday calendar from the workspace. Requires absentify Plus plan. |
| [Plus] Delete a request |
Delete a leave request permanently. Requires absentify Plus plan. |
| [Plus] Get absences |
Retrieve absences for a specific date range. Returns approved leave requests within the specified period. Requires absentify Plus plan. |
| [Plus] Get all departments |
Retrieve all departments in the workspace. Requires absentify Plus plan. |
| [Plus] Get all leave types |
Retrieve all leave types configured in the workspace. Requires absentify Plus plan. |
| [Plus] Get all members |
Get all members with optional filters for departments, status, employment dates, admin status, approval process, approvers, allowance types, name, birthday month, and manager type. Requires absentify Plus plan. |
| [Plus] Get all public holiday calendars |
Retrieve all public holiday calendars configured in the workspace. Requires absentify Plus plan. |
| [Plus] Get all requests |
Retrieve all leave requests with optional filters. Requires absentify Plus plan. |
| [Plus] Get member by custom ID |
Retrieve a member by their custom ID. Requires absentify Plus plan. |
| [Plus] Get member by email |
Retrieve a member by their email address. Requires absentify Plus plan. |
| [Plus] Get member by ID |
Retrieve a specific member by their unique ID. Requires absentify Plus plan. |
| [Plus] Get member by Microsoft ID |
Retrieve a member by their Microsoft user ID. Requires absentify Plus plan. |
| [Plus] Get public holiday calendar by ID |
Retrieve a specific public holiday calendar with all its holidays. Requires absentify Plus plan. |
| [Plus] Get request by ID |
Retrieve a specific leave request by its unique ID. Requires absentify Plus plan. |
| [Plus] Get workspace settings |
Retrieve the workspace settings and configuration. Requires absentify Plus plan. |
| [Plus] Invite a member |
Invite a new member to the workspace. Requires absentify Plus plan. |
| [Plus] Update a department |
Update an existing department. Requires absentify Plus plan. |
| [Plus] Update a leave type |
Update an existing leave type. Requires absentify Plus plan. |
| [Plus] Update a member |
Update an existing member's information. Requires absentify Plus plan. |
| [Plus] Update a public holiday calendar |
Update an existing public holiday calendar. Requires absentify Plus plan. |
| [Plus] Update a request |
Update the status of a leave request (approve, decline, or cancel). Requires absentify Plus plan. |
| [Plus] Update member allowance |
Update a member's allowance for a specific allowance type and year. Requires absentify Plus plan. |
| [Plus] Update member approvers |
Update the approvers for a specific member. Supports Microsoft profile managers, department settings, or custom approvers. Requires absentify Plus plan. |
[Plus] Add member schedule
Add a new work schedule for a member. Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Member ID
|
id | True | string |
The unique identifier of the member. |
|
From Date
|
from | string |
Start date for this schedule (YYYY-MM-DD). |
|
|
Monday AM Enabled
|
monday_am_enabled | boolean |
Whether Monday morning is enabled. |
|
|
Monday PM Enabled
|
monday_pm_enabled | boolean |
Whether Monday afternoon is enabled. |
|
|
Tuesday AM Enabled
|
tuesday_am_enabled | boolean |
Whether Tuesday morning is enabled. |
|
|
Tuesday PM Enabled
|
tuesday_pm_enabled | boolean |
Whether Tuesday afternoon is enabled. |
|
|
Wednesday AM Enabled
|
wednesday_am_enabled | boolean |
Whether Wednesday morning is enabled. |
|
|
Wednesday PM Enabled
|
wednesday_pm_enabled | boolean |
Whether Wednesday afternoon is enabled. |
|
|
Thursday AM Enabled
|
thursday_am_enabled | boolean |
Whether Thursday morning is enabled. |
|
|
Thursday PM Enabled
|
thursday_pm_enabled | boolean |
Whether Thursday afternoon is enabled. |
|
|
Friday AM Enabled
|
friday_am_enabled | boolean |
Whether Friday morning is enabled. |
|
|
Friday PM Enabled
|
friday_pm_enabled | boolean |
Whether Friday afternoon is enabled. |
|
|
Saturday AM Enabled
|
saturday_am_enabled | boolean |
Whether Saturday morning is enabled. |
|
|
Saturday PM Enabled
|
saturday_pm_enabled | boolean |
Whether Saturday afternoon is enabled. |
|
|
Sunday AM Enabled
|
sunday_am_enabled | boolean |
Whether Sunday morning is enabled. |
|
|
Sunday PM Enabled
|
sunday_pm_enabled | boolean |
Whether Sunday afternoon is enabled. |
Returns
The ID of the schedule.
- response
- string
[Plus] Create a department
Create a new department in the workspace. Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Name
|
name | True | string |
Name of the department. |
Returns
The ID of the created department.
- response
- string
[Plus] Create a leave type
Create a new leave type in the workspace. Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Name
|
name | True | string |
Name of the leave type. |
|
Leave Unit
|
leave_unit | string |
Unit for this leave type. |
|
|
Color
|
color | string |
Color code for this leave type. |
|
|
Icon
|
icon | string |
Icon for this leave type. |
Returns
The ID of the created leave type.
- response
- string
[Plus] Create a public holiday calendar
Create a new public holiday calendar in the workspace. Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Name
|
name | True | string |
Name of the public holiday calendar. |
|
Country
|
country | string |
Country code for the public holidays. |
Returns
The ID of the created public holiday calendar.
- response
- string
[Plus] Create a request
Create a new leave request for a member. Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Member ID
|
member_id | True | string |
ID of the member requesting leave. |
|
Leave Type ID
|
leave_type_id | True | string |
ID of the leave type. |
|
Start Date
|
start | True | string |
Start date of the leave (YYYY-MM-DD). |
|
Start Time
|
start_at | string |
Time of day when the leave starts. |
|
|
End Date
|
end | True | string |
End date of the leave (YYYY-MM-DD). |
|
End Time
|
end_at | string |
Time of day when the leave ends. |
|
|
Reason
|
reason | string |
Reason for the leave request. |
Returns
The ID of the created request.
- response
- string
[Plus] Delete a department
Delete a department from the workspace. Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Department ID
|
id | True | string |
The unique identifier of the department. |
Returns
The ID of the deleted department.
- response
- string
[Plus] Delete a leave type
Delete a leave type from the workspace. Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Leave Type ID
|
id | True | string |
The unique identifier of the leave type. |
Returns
The ID of the deleted leave type.
- response
- string
[Plus] Delete a member
Delete a member. All data will be deleted permanently. Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Member ID
|
id | True | string |
The unique identifier of the member. |
Returns
The ID of the deleted member.
- response
- string
[Plus] Delete a public holiday calendar
Delete a public holiday calendar from the workspace. Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Public Holiday Calendar ID
|
id | True | string |
The unique identifier of the public holiday calendar. |
Returns
The ID of the deleted public holiday calendar.
- response
- string
[Plus] Delete a request
Delete a leave request permanently. Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Request ID
|
id | True | string |
The unique identifier of the request. |
Returns
The ID of the deleted request.
- response
- string
[Plus] Get absences
Retrieve absences for a specific date range. Returns approved leave requests within the specified period. Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Start Date
|
start | True | date |
Start date for the absence query (YYYY-MM-DD). |
|
End Date
|
end | True | date |
End date for the absence query (YYYY-MM-DD). |
|
Member ID
|
member_id | string |
Filter by member ID. |
|
|
Department ID
|
department_id | string |
Filter by department ID. |
Returns
- response
- array of Absence
[Plus] Get all departments
Retrieve all departments in the workspace. Requires absentify Plus plan.
Returns
- response
- array of Department
[Plus] Get all leave types
Retrieve all leave types configured in the workspace. Requires absentify Plus plan.
Returns
- response
- array of LeaveType
[Plus] Get all members
Get all members with optional filters for departments, status, employment dates, admin status, approval process, approvers, allowance types, name, birthday month, and manager type. Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Department IDs
|
department_ids | array |
Filter by department IDs. |
|
|
Status
|
status | string |
Filter by member status. |
|
|
Employment Start From
|
employment_start_date_from | string |
Filter by employment start date (from). |
|
|
Employment Start To
|
employment_start_date_to | string |
Filter by employment start date (to). |
|
|
Employment End From
|
employment_end_date_from | string |
Filter by employment end date (from). |
|
|
Employment End To
|
employment_end_date_to | string |
Filter by employment end date (to). |
|
|
Is Admin
|
is_admin | boolean |
Filter by admin status. |
|
|
Approval Process
|
approval_process | string |
Filter by approval process type. |
|
|
Has Approvers
|
has_approvers | boolean |
Filter by whether member has approvers. |
|
|
Allowance Type ID
|
allowance_type_id | string |
Filter by allowance type ID. |
|
|
Name
|
name | string |
Filter by member name. |
|
|
Birthday Month
|
birthday_month | integer |
Filter by birthday month (1-12). |
|
|
Manager Type
|
manager_type | string |
Filter by manager type. |
Returns
- response
- array of Member
[Plus] Get all public holiday calendars
Retrieve all public holiday calendars configured in the workspace. Requires absentify Plus plan.
Returns
- response
- array of PublicHolidayCalendar
[Plus] Get all requests
Retrieve all leave requests with optional filters. Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Member ID
|
member_id | string |
Filter by member ID. |
|
|
Status
|
status | string |
Filter by request status. |
|
|
Start From
|
start_from | string |
Filter by start date (from). |
|
|
Start To
|
start_to | string |
Filter by start date (to). |
|
|
End From
|
end_from | string |
Filter by end date (from). |
|
|
End To
|
end_to | string |
Filter by end date (to). |
|
|
Leave Type ID
|
leave_type_id | string |
Filter by leave type ID. |
|
|
Department ID
|
department_id | string |
Filter by department ID. |
Returns
- response
- array of Request
[Plus] Get member by custom ID
Retrieve a member by their custom ID. Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Custom ID
|
custom_id | True | string |
The custom ID of the member. |
Returns
Detailed member information including schedules.
- Member Detail
- MemberDetail
[Plus] Get member by email
Retrieve a member by their email address. Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Email
|
True | string |
The email address of the member. |
Returns
Detailed member information including schedules.
- Member Detail
- MemberDetail
[Plus] Get member by ID
Retrieve a specific member by their unique ID. Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Member ID
|
id | True | string |
The unique identifier of the member. |
Returns
Detailed member information including schedules.
- Member Detail
- MemberDetail
[Plus] Get member by Microsoft ID
Retrieve a member by their Microsoft user ID. Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Microsoft User ID
|
microsoft_user_id | True | string |
The Microsoft user ID. |
Returns
Detailed member information including schedules.
- Member Detail
- MemberDetail
[Plus] Get public holiday calendar by ID
Retrieve a specific public holiday calendar with all its holidays. Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Public Holiday Calendar ID
|
id | True | string |
The unique identifier of the public holiday calendar. |
Returns
Detailed public holiday calendar with holidays.
- Public Holiday Calendar Detail
- PublicHolidayCalendarDetail
[Plus] Get request by ID
Retrieve a specific leave request by its unique ID. Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Request ID
|
id | True | string |
The unique identifier of the request. |
Returns
A leave request.
- Request
- Request
[Plus] Get workspace settings
Retrieve the workspace settings and configuration. Requires absentify Plus plan.
Returns
Workspace settings and configuration.
- Workspace
- Workspace
[Plus] Invite a member
Invite a new member to the workspace. Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Name
|
name | True | string |
Name of the member to invite. |
|
Email
|
string |
Email address of the member. |
||
|
Department ID
|
id | string |
Department ID. |
|
|
Employment Start Date
|
employment_start_date | string |
Employment start date. |
|
|
Public Holiday Calendar ID
|
public_holiday_id | True | string |
ID of the public holiday calendar to assign. |
|
Birthday
|
birthday | string |
Birthday of the member. |
|
|
Custom ID
|
custom_id | string |
Custom identifier for the member. |
Returns
The ID of the invited member.
- response
- string
[Plus] Update a department
Update an existing department. Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Department ID
|
id | True | string |
The unique identifier of the department. |
|
Name
|
name | string |
Name of the department. |
Returns
The ID of the updated department.
- response
- string
[Plus] Update a leave type
Update an existing leave type. Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Leave Type ID
|
id | True | string |
The unique identifier of the leave type. |
|
Name
|
name | string |
Name of the leave type. |
|
|
Leave Unit
|
leave_unit | string |
Unit for this leave type. |
|
|
Color
|
color | string |
Color code for this leave type. |
|
|
Icon
|
icon | string |
Icon for this leave type. |
Returns
The ID of the updated leave type.
- response
- string
[Plus] Update a member
Update an existing member's information. Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Member ID
|
id | True | string |
The unique identifier of the member. |
|
Is Admin
|
is_admin | boolean |
Whether the member should be an admin. |
|
|
Department ID
|
id | string |
Department ID. |
|
|
Employment Start Date
|
employment_start_date | string |
Employment start date. |
|
|
Employment End Date
|
employment_end_date | string |
Employment end date. |
|
|
Public Holiday Calendar ID
|
public_holiday_id | string |
ID of the public holiday calendar to assign. |
|
|
Birthday
|
birthday | string |
Birthday of the member. |
|
|
Custom ID
|
custom_id | string |
Custom identifier for the member. |
|
|
Status
|
status | string |
Status of the member. |
Returns
The ID of the updated member.
- response
- string
[Plus] Update a public holiday calendar
Update an existing public holiday calendar. Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Public Holiday Calendar ID
|
id | True | string |
The unique identifier of the public holiday calendar. |
|
Name
|
name | string |
Name of the public holiday calendar. |
|
|
Country
|
country | string |
Country code for the public holidays. |
Returns
The ID of the updated public holiday calendar.
- response
- string
[Plus] Update a request
Update the status of a leave request (approve, decline, or cancel). Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Request ID
|
id | True | string |
The unique identifier of the request. |
|
Status
|
status | True | string |
New status for the request. |
|
Reason
|
reason | string |
Reason for the status change. |
Returns
The ID of the updated request.
- response
- string
[Plus] Update member allowance
Update a member's allowance for a specific allowance type and year. Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Member ID
|
id | True | string |
The unique identifier of the member. |
|
Allowance Type ID
|
allowance_type_id | True | string |
The unique identifier of the allowance type. |
|
Year
|
year | True | integer |
The year for the allowance. |
|
Allowance
|
allowance | True | number |
Total allowance amount. |
|
Compensatory Time Off
|
compensatory_time_off | True | number |
Compensatory time off to add. |
|
Brought Forward
|
brought_forward | number |
Allowance brought forward from previous year. |
|
|
Reason
|
reason | string |
Reason for the allowance update. |
|
|
Overwrite Brought Forward
|
overwrite_brought_forward | boolean |
Whether to overwrite the brought forward value. |
|
|
Set as Default
|
set_as_default | boolean |
Whether to set this allowance type as default for the member. |
|
|
Disabled
|
disabled | boolean |
Whether to disable this allowance type for the member. |
Returns
The ID of the member.
- response
- string
[Plus] Update member approvers
Update the approvers for a specific member. Supports Microsoft profile managers, department settings, or custom approvers. Requires absentify Plus plan.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Member ID
|
id | True | string |
The unique identifier of the member. |
|
Approval Process
|
approval_process | True | string |
Type of approval process. |
|
Member ID
|
member_id | string |
ID of the approver member. |
|
|
Predecessor Manager ID
|
predecessor_manager_id | string |
ID of the predecessor manager (for linear approval). |
Returns
The ID of the member.
- response
- string
Triggers
| When a leave request is created |
Triggers when any employee in your organization submits a new leave or absence request. Use this to start approval workflows, send notifications, or update external calendars. |
| When a leave request status changes |
Triggers when the status of a leave request changes (approved, declined, or canceled). Use this to notify employees, update HR systems, or sync calendar entries. |
When a leave request is created
Triggers when any employee in your organization submits a new leave or absence request. Use this to start approval workflows, send notifications, or update external calendars.
Returns
Webhook payload containing leave request data.
- Request Webhook Payload
- RequestWebhookPayloadV2
When a leave request status changes
Triggers when the status of a leave request changes (approved, declined, or canceled). Use this to notify employees, update HR systems, or sync calendar entries.
Returns
Webhook payload containing leave request data.
- Request Webhook Payload
- RequestWebhookPayloadV2
Definitions
RequestWebhookPayloadV2
Webhook payload containing leave request data.
| Name | Path | Type | Description |
|---|---|---|---|
|
Event Type
|
event_type | string |
The type of event that triggered this webhook. |
|
Request Body
|
body | RequestBodyV2 |
The leave request details. |
RequestBodyV2
The leave request details.
| Name | Path | Type | Description |
|---|---|---|---|
|
Request ID
|
id | string |
Unique identifier of the leave request. |
|
Created At
|
createdAt | string |
Timestamp when the request was created. |
|
Updated At
|
updatedAt | string |
Timestamp when the request was last updated. |
|
Start Date
|
start | string |
Start date of the leave request. |
|
Start Time
|
start_at | string |
Time of day when the leave starts. |
|
End Date
|
end | string |
End date of the leave request. |
|
End Time
|
end_at | string |
Time of day when the leave ends. |
|
Leave Unit
|
leave_unit | string |
Unit used for measuring the leave duration. |
|
Status
|
status | string |
Current status of the leave request. |
|
Reason
|
reason | string |
Reason provided for the leave request. |
|
Approval Process
|
approval_process | string |
Type of approval process for this request. |
|
Cancel Reason
|
cancel_reason | string |
Reason for cancellation if the request was canceled. |
|
Canceled Date
|
canceld_date | string |
Date when the request was canceled. |
|
Member
|
canceld_by_member | MemberReference |
Reference to a member. |
|
Workday Duration
|
workday_absence_duration | float |
Duration of absence in workdays. |
|
Total Duration
|
duration | float |
Total duration of the leave request. |
|
Take From Allowance
|
take_from_allowance | boolean |
Whether this leave is deducted from the allowance. |
|
Member
|
request_creator_member | MemberReference |
Reference to a member. |
|
Member
|
requester_member | MemberReference |
Reference to a member. |
|
Leave Type
|
leave_type | LeaveTypeV2 |
Information about the leave type. |
|
Allowance Type
|
allowance_type | AllowanceTypeV2 |
Information about the allowance type. |
|
Request Approvers
|
request_approvers | array of RequestApproverV2 |
List of approvers for this request. |
MemberReference
Reference to a member.
| Name | Path | Type | Description |
|---|---|---|---|
|
Member ID
|
id | string |
Unique identifier of the member. |
|
Custom ID
|
custom_id | string |
Custom identifier for the member. |
|
Name
|
name | string |
Name of the member. |
|
Email
|
string |
Email address of the member. |
LeaveTypeV2
Information about the leave type.
| Name | Path | Type | Description |
|---|---|---|---|
|
Leave Type ID
|
id | string |
Unique identifier of the leave type. |
|
Leave Type Name
|
name | string |
Name of the leave type. |
|
Leave Unit
|
leave_unit | string |
Unit of the leave type. |
AllowanceTypeV2
Information about the allowance type.
| Name | Path | Type | Description |
|---|---|---|---|
|
Allowance Type ID
|
id | string |
Unique identifier of the allowance type. |
|
Allowance Type Name
|
name | string |
Name of the allowance type. |
|
Ignore Limit
|
ignore_allowance_limit | boolean |
Whether the allowance limit should be ignored. |
|
Allowance Unit
|
allowance_unit | string |
Unit of the allowance. |
RequestApproverV2
Information about a request approver.
| Name | Path | Type | Description |
|---|---|---|---|
|
Approver Status
|
status | string |
Current approval status. |
|
Approver Reason
|
reason | string |
Reason provided by the approver. |
|
Status Changed Date
|
status_changed_date | string |
Date when the approval status was changed. |
|
Member
|
status_changed_by_member | MemberReference |
Reference to a member. |
|
Member
|
approver_member | MemberReference |
Reference to a member. |
Member
A member in the workspace.
| Name | Path | Type | Description |
|---|---|---|---|
|
Member ID
|
id | string |
Unique identifier of the member. |
|
Custom ID
|
custom_id | string |
Custom identifier for the member. |
|
Name
|
name | string |
Name of the member. |
|
Email
|
string |
Email address of the member. |
|
|
Created At
|
createdAt | string |
Timestamp when the member was created. |
|
Updated At
|
updatedAt | string |
Timestamp when the member was last updated. |
|
Status
|
status | string |
Current status of the member. |
|
Birthday
|
birthday | string |
Birthday of the member. |
|
Employment Start Date
|
employment_start_date | string |
Employment start date of the member. |
|
Employment End Date
|
employment_end_date | string |
Employment end date of the member. |
|
Is Admin
|
is_admin | boolean |
Whether the member is an admin. |
|
Approval Process
|
approval_process | string |
Approval process type for this member. |
|
Departments
|
departments | array of MemberDepartment |
Departments the member belongs to. |
|
Allowances
|
allowances | array of MemberAllowance |
Allowances for the member. |
MemberDetail
Detailed member information including schedules.
| Name | Path | Type | Description |
|---|---|---|---|
|
Member ID
|
id | string |
Unique identifier of the member. |
|
Custom ID
|
custom_id | string |
Custom identifier for the member. |
|
Name
|
name | string |
Name of the member. |
|
Email
|
string |
Email address of the member. |
|
|
Created At
|
createdAt | string |
Timestamp when the member was created. |
|
Updated At
|
updatedAt | string |
Timestamp when the member was last updated. |
|
Status
|
status | string |
Current status of the member. |
|
Birthday
|
birthday | string |
Birthday of the member. |
|
Employment Start Date
|
employment_start_date | string |
Employment start date of the member. |
|
Employment End Date
|
employment_end_date | string |
Employment end date of the member. |
|
Is Admin
|
is_admin | boolean |
Whether the member is an admin. |
|
Approval Process
|
approval_process | string |
Approval process type for this member. |
|
Departments
|
departments | array of MemberDepartment |
Departments the member belongs to. |
|
Allowances
|
allowances | array of MemberAllowance |
Allowances for the member. |
|
Approvers
|
has_approvers | array of ApproverInfo |
List of approvers for this member. |
|
Schedules
|
schedules | array of Schedule |
Work schedules for the member. |
MemberDepartment
Department assignment for a member.
| Name | Path | Type | Description |
|---|---|---|---|
|
Department ID
|
id | string |
Unique identifier of the department. |
|
Department Name
|
name | string |
Name of the department. |
|
Manager Type
|
manager_type | string |
Role of the member in the department. |
MemberAllowance
Allowance information for a member.
| Name | Path | Type | Description |
|---|---|---|---|
|
Allowance ID
|
id | string |
Unique identifier of the allowance record. |
|
Year
|
year | integer |
Year for this allowance. |
|
Allowance
|
allowance | number |
Total allowance amount. |
|
Taken
|
taken | number |
Amount of allowance already taken. |
|
Remaining
|
remaining | number |
Remaining allowance amount. |
|
Brought Forward
|
brought_forward | number |
Allowance brought forward from previous year. |
|
Compensatory Time Off
|
compensatory_time_off | number |
Compensatory time off added. |
|
Allowance Type
|
allowance_type | AllowanceTypeV2 |
Information about the allowance type. |
ApproverInfo
Information about an approver.
| Name | Path | Type | Description |
|---|---|---|---|
|
Member
|
member | MemberReference |
Reference to a member. |
Schedule
Work schedule for a member.
| Name | Path | Type | Description |
|---|---|---|---|
|
Schedule ID
|
id | string |
Unique identifier of the schedule. |
|
From Date
|
from | string |
Start date of this schedule. |
|
Created At
|
createdAt | string |
Timestamp when the schedule was created. |
|
Updated At
|
updatedAt | string |
Timestamp when the schedule was last updated. |
Department
A department in the workspace.
| Name | Path | Type | Description |
|---|---|---|---|
|
Department ID
|
id | string |
Unique identifier of the department. |
|
Name
|
name | string |
Name of the department. |
|
Created At
|
createdAt | string |
Timestamp when the department was created. |
|
Updated At
|
updatedAt | string |
Timestamp when the department was last updated. |
LeaveType
A leave type in the workspace.
| Name | Path | Type | Description |
|---|---|---|---|
|
Leave Type ID
|
id | string |
Unique identifier of the leave type. |
|
Name
|
name | string |
Name of the leave type. |
|
Leave Unit
|
leave_unit | string |
Unit for this leave type. |
|
Color
|
color | string |
Color code for this leave type. |
|
Icon
|
icon | string |
Icon for this leave type. |
|
Created At
|
createdAt | string |
Timestamp when the leave type was created. |
|
Updated At
|
updatedAt | string |
Timestamp when the leave type was last updated. |
Request
A leave request.
| Name | Path | Type | Description |
|---|---|---|---|
|
Request ID
|
id | string |
Unique identifier of the request. |
|
Created At
|
createdAt | string |
Timestamp when the request was created. |
|
Updated At
|
updatedAt | string |
Timestamp when the request was last updated. |
|
Start Date
|
start | string |
Start date of the request. |
|
Start Time
|
start_at | string |
Time of day when the leave starts. |
|
End Date
|
end | string |
End date of the request. |
|
End Time
|
end_at | string |
Time of day when the leave ends. |
|
Status
|
status | string |
Current status of the request. |
|
Reason
|
reason | string |
Reason for the leave request. |
|
Duration
|
duration | number |
Duration of the leave. |
|
Workday Duration
|
workday_absence_duration | number |
Duration in workdays. |
|
Leave Unit
|
leave_unit | string |
Unit for this leave. |
|
Member
|
requester_member | MemberReference |
Reference to a member. |
|
Leave Type
|
leave_type | LeaveTypeV2 |
Information about the leave type. |
|
Approvers
|
request_approvers | array of RequestApproverV2 |
List of approvers for this request. |
PublicHolidayCalendar
A public holiday calendar.
| Name | Path | Type | Description |
|---|---|---|---|
|
Calendar ID
|
id | string |
Unique identifier of the calendar. |
|
Name
|
name | string |
Name of the public holiday calendar. |
|
Country
|
country | string |
Country for the public holidays. |
|
Created At
|
createdAt | string |
Timestamp when the calendar was created. |
|
Updated At
|
updatedAt | string |
Timestamp when the calendar was last updated. |
PublicHolidayCalendarDetail
Detailed public holiday calendar with holidays.
| Name | Path | Type | Description |
|---|---|---|---|
|
Calendar ID
|
id | string |
Unique identifier of the calendar. |
|
Name
|
name | string |
Name of the public holiday calendar. |
|
Country
|
country | string |
Country for the public holidays. |
|
Holidays
|
holidays | array of PublicHoliday |
List of holidays in this calendar. |
PublicHoliday
A public holiday.
| Name | Path | Type | Description |
|---|---|---|---|
|
Holiday ID
|
id | string |
Unique identifier of the holiday. |
|
Name
|
name | string |
Name of the holiday. |
|
Date
|
date | string |
Date of the holiday. |
|
Duration
|
duration | number |
Duration of the holiday (0.5 for half day, 1 for full day). |
Workspace
Workspace settings and configuration.
| Name | Path | Type | Description |
|---|---|---|---|
|
Workspace ID
|
id | string |
Unique identifier of the workspace. |
|
Name
|
name | string |
Name of the workspace. |
|
Created At
|
createdAt | string |
Timestamp when the workspace was created. |
|
Updated At
|
updatedAt | string |
Timestamp when the workspace was last updated. |
Absence
An absence entry.
| Name | Path | Type | Description |
|---|---|---|---|
|
Absence ID
|
id | string |
Unique identifier of the absence. |
|
Date
|
date | string |
Date of the absence. |
|
Duration
|
duration | number |
Duration of the absence. |
|
Member
|
member | MemberReference |
Reference to a member. |
|
Leave Type
|
leave_type | LeaveTypeV2 |
Information about the leave type. |
|
Request ID
|
request_id | string |
ID of the associated leave request. |
string
This is the basic data type 'string'.