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?
- Step 2. Connect to Graph API in SpaceIQ
- Step 3. Activate the Calendar from the email
- Step 4. Enter Credentials
- Step 5. Permissions Requested
- Step 6. Review the Cronofy access in Azure Active Directory
- Step 7. Calendar Synchronization and Test
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.
- In the top-right corner, click your Profile Name.
- Click Settings.
- From the left menu, click Integrations.
- From the Third Party Integrations area, click READ MORE.
- From the left, menu Meeting Rooms.
- From the Active list, click the Office365 Calendar and the Office365 Calendar dialog displays.
- Click the Delete icon and the message "Delete this integration?" displays.
- Click the Yes button.
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.
- From the Meeting Rooms - Available list, find the Office365 Calendar tile.
- Click the Activate button.
- In the Office365 Domain Name field, enter admin domain. Note that the Admin and Service Account domain must be the same.
- 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.
- Right-click the Active Calendar link and then copy the URL.
- Open an incognito browser.
- Paste in the URL.
Step 4. Enter Credentials
You will now be prompted to select the calendar service.
- Select the Office 365 option.
- 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:
- First, to confirm your Office 365 tenancy,
- Second, to request the necessary scopes for Enterprise Connect. Which Graph scopes does Cronofy utilize? | Cronofy Docs.
- Click the Accept button and then the integration success screen displays.
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
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.