Skip to main content
Eptura Knowledge Center

Integrate Office 365 Calendar Using Graph API

Level: Customer IT

If you use Office 365 for your calendar integration with SpaceIQ, then complete these steps before January 31st, 2025 to prevent the integration from breaking. 

These steps will need to be completed by an Administrator for Microsoft Ofifce365 and an Administrator for SpaceIQ.

Steps


Step 1. Do you have an existing Office 365 integration?


If you have an existing Office 365 integration, you will need to first disconnect the integration from SpaceIQ.

  1. In the top-right corner, click your Profile Name.
  2. Click Settings.
  3. From the left menu, click Integrations.
  4. From the Third Party Integrations area, click READ MORE.
  5. From the left, menu Meeting Rooms.
  6. From the Active list, click the Office365 Calendar and the Office365 Calendar dialog displays.
  7. Click the Deleteclipboard_eca78df9a58ea6ec0415d7a02792852d8.png icon and the message "Delete this integration?" displays.
  8. Click the Yes button.

clipboard_e4af5d23adb812d0f2e0994156d5211cc.png

When this step is completed, SpaceIQ will no longer be receiving free/busy information from your Outlook calendars and integration will be down. 

Step 2. Connect to Graph API in SpaceIQ

Now your Administrator can connect to the Graph API in SpaceIQ.

  1. From the Meeting Rooms - Available list, find the Office365 Calendar tile.
  2. Click the Activate button.

clipboard_e7dc2ba60adffaf18db220c439d12ad25.png

  1. In the Office365 Domain Name field, enter admin domain. Note that the Admin and Service Account domain must be the same.
  2. Click the Activate button.

Step 3. Activate the Calendar from the email

The person who completed the above step will receive an email from no-reply@spaceiq.com.

Do not click the “ACTIVATE CALENDAR” link!

 
If the link is opened in the user’s standard browser, the integration will be linked to the active account being used in that browser. If the integration is accidently linked to the wrong account, then you can always disconnect and restart the integration from step 1.

  1. Right-click the Active Calendar link and then copy the URL.

clipboard_e537dd257c018ab521a15e7aec1f20681.png

  1. Open an incognito browser.
  2. Paste in the URL.   

Step 4. Enter Credentials 

You will now be prompted to select the calendar service.

clipboard_e8c23931af39e135b1eacc4757b975547.png

  1. Select the Office 365 option.
  2. You will be prompted to enter your Administrator credentials. This is the minimum level of access you will require to enable Enterprise Connect.

Step 5. Permissions Requested

You will see this screen twice:

clipboard_eb2b7fbb6d38d5ce461a4b67b666bb916.png clipboard_e732ee9658407ea524a4705539ab189bc.png
  •  Click the Accept button and then the integration success screen displays.

clipboard_e3f89ef29dcf96177ec134374ba7f6bcf.png

Step 6. Review the Cronofy Access in Azure Active Directory

Review Azure Active Directory to ensure Cronofy has the appropriate level of access for the integration. Reference: Limit Cronofy's access | Cronofy Docs

Cronofy requires the following scopes when connecting via Enterprise Connect: 

  • User.Read.All 
  • Organization.Read.All 
  • Places.Read.All 
  • Calendars.ReadWrite 

clipboard_e2d1e0b31dcc5743642903ebe1280b9ac.png

Step 7. Calendar Synchronization and Test 

After these steps are completed, the calendars will start to synchronize and it may take a few hours for this process to complete if you have a large number of rooms. 

When the rooms have synced, we recommend you test the integration.

Remember to add any new the resource's calendar to the Meeting Room icon in SpaceIQ, learn more in Add Meeting Room icon to the Floor Map.