What information is synced between Microsoft 365 & Worka?
The integration between Microsoft 365 & Worka is currently used to sync the availability of meeting rooms only.
How do I connect Worka to my Microsoft 365 Calendar?
From the Worka Partner Portal, click the settings cog on the top right-hand side of the page, you’ll then be asked to enter three separate IDs to sync between Worka and Microsoft 365.
How do I generate the Application ID, Directory ID, and Secret ID required to link Microsoft 365 to Worka?
1. Create an App Registration
Navigate to Microsoft Entra (admin center)
Click the Identity tab, then the Applications tab
Click App Registrations
Click New Registration and give it a name e.g Worka
Under Redirect URL, choose Web and enter https://worka.com in the field below
Click Register
Make a note of the Application (client) ID
Make a note of the Directory (tenant) ID
2. Generate a Client Secret
From the left-hand menu, click the Certificates & secrets tab
Click New Client Secret, and choose an expiration date (2 years maximum)
Make a note of the newly generated Secret Value
3. Add permissions
From the left-hand menu, click the API permissions tab
Click Add a permission
In the popup, click the Microsoft Graph button
Click the Application permissions button
Search for Place.Read.All and tick the permission. This is required so we can find out details about workspaces in your organisation, such as meeting room capacity
Search for User.ReadBasic.All and tick the permission. This is required because calendars have an associated user, and we need to discover some identifiers for the calendar users
Search for Calendars.ReadWrite and tick the permission. This is required so we can read and write events in the calendar for each workspace
Click Add permissions
Click the Grant admin consent button (or ask your administrator to do so if you don’t have the required permissions)
4. Optional: Restrict access to specific calendars
Warning: this is an advanced guide and requires running PowerShell commands to complete.
If you have many calendars in your organisation and you only want Worka to have access to a selection of them, you can follow this guide to limit access to specific calendars: https://learn.microsoft.com/en-us/graph/auth-limit-mailbox-access.
Once complete, these restrictions can take over an hour to take effect.
5. Enter the details into Worka
Add your Application ID, Directory ID & Secret Value into Worka.
Once you’ve entered these details, click the Connect button to complete the setup.
