Connect Microsoft 365 via the Robin OAuth App

Install Robin's sync app on your Microsoft 365 account to connect room calendars to spaces in Robin. The app is a domain-level "Enterprise App" with permission to manage room resources in your account. You can see a list of the other apps you installed this way.

If you are new to Microsoft 365, see Microsoft's guide to administering apps like Robin.

Required permissions to complete this step

You need a Microsoft global admin. A user with the Application Administrator and Privileged Role Administrator roles can also install the app.

Install the app

  1. Go to the Manage tab in Robin's web dashboard.
  2. Select the Integrations tab, then select "Connect" for Microsoft 365.

    2024-02-01_11-52-58.png

  3. In "Choose how to connect", select Connect via App.

    image.png

  4. This starts the OAuth flow, which connects to your account and installs the app. The window asks for account credentials or shows a list of your Microsoft accounts. The app is for your entire domain, so use a global administrator account for this step.

    2024-02-01_11-49-07.png

    Common pitfall

    If you see the screen below after you select "Accept", your account is not a Global Admin. Log in with a different account, or ask your IT department to change your user permissions until you finish the installation.

  5. Robin asks for permission to access calendar information to sync events. Accept permissions to proceed.

    Why Robin asks for full access to all mailboxes

    Robin uses an authentication method called OAuth to install the app on your Microsoft 365 account securely. With OAuth, an app requests very specific rights for your account. For Microsoft 365/EWS, Microsoft requires that all OAuth apps request mailbox permission for EWS APIs. After installation, the Robin app interacts only with your calendars.

    Read more about app privileges in Microsoft 365.

    Screenshot 2025-01-16 at 1.47.29 PM.png

You can now pair calendars managed by this account to your spaces. To confirm, check that Robin shows in your domain's app overview: http://myapps.microsoft.com

Single sign-on troubleshooting

If you see the screen below when you log in to Robin with single sign-on, enable user consent at the organizational level. Users can then log in with Microsoft 365.

need_permission2.png

The Robin app is not in the Microsoft Store, so single sign-on for Microsoft 365 requires user consent.

Articles in this section

Was this article helpful?
2 out of 7 found this helpful
Share