Support Portal

Submit a ticket My Tickets
Welcome
Login  Sign up

Calendar Integration - Microsoft Graph API

This guide has been created for system administrators.

Specific role permissions may be required, including: System Setup.


Overview:

Graph API is a restful API (Application Programming Interface) service that allows for the calendar data from edays to be shared with the Microsoft cloud environment of Microsoft 365. Graph API allows for instantaneous sharing of calendar data from edays. 


Please note: When enabling the Graph API function on your system it is important to remember that this will affect all users – this function cannot be configured for specific users or templates.


To enable integration via the Graph API please follow these steps:

Please note: the following steps require a Microsoft365 account with elevated privileges. Your IT team will typically be required to assist with this setup internally.

  • Navigate to Admin tools > Admin panel.
  • Go to Global > Calendar integration.
  • Click the orange “Authorise edays” button.
  • Log in to the account that has elevated Microsoft privileges.
  • You will then be presented with a screen asking for you to grant permission for e-days to read and write calendars to all mailboxes and to sign in and read user profiles (This is no different from the current exchange integration process), click Accept.


You will then be re-directed to edays where you will be able to manage your integration settings – Hover over the information icon for more information on the below.

  • Enable calendar integration: This must be enabled for the integration to work.
  • Add user entries: This will add the user's own absences to their calendar.
  • Add manager entries: This will add users’ absences to their managers' calendars (The manager must be the primary authoriser for this to work).
  • See full-day entries: This will show days-based absences as an entire day rather than display in hours.
  • Enable reminders: Allows your email software to remind the user of their upcoming absences.
  • Click Save.


Once this is done the integration will be set up and absences within edays will start integrating with your Outlook calendar moving forwards.


You can manage which absence type names should be displayed in calendars and this can be set on a global, template or user level with the 'Can view description in the exported calendar' absence type permission. Please click the required link below to view our guide to updating absence type permissions.

n.b. if 'Can view description in the exported calendar' is set to 'No', absences will display in calendars as either 'Planned' or 'Unplanned'.


Updating Absence Type Permissions - Global Level

Updating Absence Type Permissions - Template Level

Updating Absence Type Permissions - User Level



Related Guides:

Choosing a Calendar Integration - iCal, Graph API or Exchange



Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.