Connect to Office 365

Choose how you want to connect

Administrators can connect Robin with Office 365 using one of two methods; via a service account, or installing the Robin application directly on your team's domain. See below for more information on the two possible options for connecting Office 365 to Robin.


Installing the application allows teams to set it and forget it. This method, which requires connection with the O365 Global Admin account, installs the app for the entire O365 tenant -- the benefit being you don't have to keep updating permissions as you add new calendars. 

Service Account

A service account is more configurable and is good for teams that want to maintain the highest level of control over permissions, access logs, etc. This approach may feel more comfortable for folks familiar with Exchange. The service account should have impersonation access for all of the room calendars you'd like Robin to manage. This enables creating and editing events through Robin. 

Option 1: Connect a service account

Navigate to the Settings tab within Robin's web dashboard
 Select the Integrations tab, and click "Connect" Office 365. 
You will be provided a pop up window to choose how to connect to Office 365. For our purposes you will choose "Connect Service Account". 
You will be prompted to enter your credentials. Robin will then ask for permission to access calendar information in order to sync events. Accept permissions to proceed and complete your connection.


"You can't access this application"

If the pop up window from Microsoft results in something like "Robin Powered Service needs permission to access resources in your organization that only an admin can grant. Please ask an admin to grant permission to this app before you can use it", you may need to update your Office 365 settings to allow non-admins to sign in to apps like Robin.

For extra help, you can find the specific resolutions on Microsoft's Azure Consent error guide here.

Option 2: Install the app to Office 365

New to Office 365? Microsoft has a great guide to administering apps like Robin

Here's how to install Robin's syncing app onto your Office 365 account, which will allow you to connect room calendars to spaces in Robin. This will install a domain-level app which has permission to manage room resources within your account. You can see a list of other apps you've installed this way here.

You must be a global administrator to complete this step

This app will be installed for your entire organization, so you will need a global administrator to complete this step. If you'd like to understand more about why a Global Admin is needed, start with this article.

Navigate to the Settings tab within Robin's web dashboard. 
Select the Integrations tab, and click "Connect" Office 365. 

This will start the OAuth flow to connect to your account and install the app. The window will prompt you to enter account credentials or show you a list of your Microsoft Accounts. Since this will be an app for your entire domain, you will need to use a global administrator account to complete this step.


Common pitfall

If you see the screen below after pressing "Accept", it means your account is not a Global Admin. You will need to log in using a different account or have your IT department temporarily change your user permissions until you've completed the installation.

Robin will ask for permission to access calendar information in order to sync events. Accept permissions to proceed. 


"Why does it ask for full access to all mailboxes?"

Robin uses an authentication method called OAuth to securely install the app onto your Office 365 account. OAuth is a way for apps to request very specific rights for your account. For Office 365/EWS, Microsoft (for some inexplicable reason) requires that all OAuth apps request this permission, whether or not you use it. Robin does not. Once installed, the Robin app only interacts with your calendars.

You can read more about app privileges in Office 365 here.

You're all set! You can now pair calendars managed by this account to your spaces. You can confirm by seeing if Robin is visible from your domain's app overview:

Next up

Now that you've connected the app, let's connect a room calendar to a space in Robin.

Learn more

For more about enabling single sign on via Office 365 check out this article.

Did this article help?