Hive connects to Microsoft 365 with delegated Microsoft Graph permissions. Each person approves them for their own account on a Microsoft permission screen. Your organization's Microsoft consent settings decide if users can approve these permissions themselves. Microsoft's default settings do not let users approve some of them, for example access to all files (Files.ReadWrite.All). If your users see a message that they need admin approval, see Approve Hive for your whole organization below.
Every connection on this page
Each Microsoft connection on this page asks for these permissions:
Scope | Permission | How it's used by Hive |
openid | Sign users in | Signs you in to Hive with your Microsoft account. |
View users' email address | Identifies the Microsoft account you connect. | |
User.Read | Sign in and read user profile | Reads your basic profile to identify the connected account. |
offline_access | Maintain access to data you have given it access to | Keeps your connection active, so you do not have to sign in again each time Hive syncs. |
Sign in with Microsoft
When you sign in to Hive with Sign in with Microsoft, Microsoft asks for the OneDrive and Calendar permissions below on one screen.
Hive Apps - OneDrive
The "OneDrive" Hive App allows for seamless integration of your Microsoft OneDrive cloud file storage to enable quick browsing and attachment of OneDrive + Sharepoint files onto multiple resources in Hive.
The scope(s) required for the integration to function are listed below:
Scope | Permission | How it's used by Hive |
Files.ReadWrite.All | Have full access to all files user can access | Used to fetch OneDrive file data for opening the OneDrive file picker. Read access enabled for "all" so that users can select and attach any files from their Microsoft OneDrive and Sharepoint site files. Write access enabled so that users can leverage OneDrive file picker upload capabilities to add new files to OneDrive through the picker before attaching into Hive. |
Hive Apps - Calendar (Office 365)
The "Calendar" Hive App allows for seamless integration of your calendar into Hive so that you can easily view a pop-out calendar view from inside of Hive to easily view your schedule, respond/update calendar events, get meeting reminders, open video conferencing, schedule work blocks for Actions, and integrate meeting notes for calendar events before/during/after your meetings.
The scope(s) required for the integration to function are listed below:
Scope | Permission | How it's used by Hive |
Calendars.ReadWrite | Have full access to user calendars | Read access shows your calendar events in Hive. Write access lets you respond to events and add events from Hive. |
Calendars.ReadWrite.Shared | Have full access to user calendars | Read access is used to populate the "My Day" interface in Hive with calendar events and details. It is also used to allow syncing of calendar events to Hive Notes. Write access is used to respond to events from "My Day" and schedule events from Hive Actions. Shared access is used to help users avoid conflict when using Scheduling. |
Hive Apps - Mail (Office 365)
The "Mail" Hive App allows for seamless integration of your Microsoft 365 email account so you can access your inbox, send new messages, organize email follow-ups, and more, all without ever leaving Hive.
The scope(s) required for the integration to function are listed below:
Scope | Permission | How it's used by Hive |
Files.ReadWrite.All | Have full access to all files user can access | Read access is used to fetch OneDrive file data for adding attachments to emails sent from inside of Hive. Write access is used to upload file attachments which exceed a size which restricts them from being compatible with email standards; large files are instead uploaded to OneDrive and added as an attachment. |
Calendars.Read | Read user calendars | Reads event details for emails that are meeting invites. |
Calendars.ReadWrite | Have full access to user calendars | Read access is used to fetch calendar event details in the email client for emails which are meeting invites, allowing dynamic rendering of event details in Hive. Write access is used to respond to events from dynamically rendered emails. |
People.Read | Read users' relevant people lists | Read access is used to load in contacts when sending emails from inside of Hive such that contacts are auto-populated and searchable as expected for any modern email client. |
Mail.ReadWrite | Read and write access to user mail | Read access is used to load mailboxes and emails into the email client. Write access is used to allow for common mail updates such as "mark as read", "archive", "move", etc. |
Mail.Send | Send mail as a user | Mail send is used to create and send emails, reply to emails, and write email drafts. |
Approve Hive for your whole organization
If your organization does not let users approve these permissions, a Microsoft administrator can approve Hive for everyone. Both options below need the Global Administrator or Privileged Role Administrator role in Microsoft Entra.
Option 1: Approve only Mail and Calendar (recommended)
The administrator must have a Hive account for this option.
Sign in to Hive with the administrator's Microsoft account.
Turn on Hive Mail and Hive Calendar from Apps.
On each Microsoft permission screen that opens, select Consent on behalf of your organization, then select Accept. This includes the screen at sign-in, if Microsoft shows one.
This approves the permissions on those screens for all users in your organization.
To check the result, open the Microsoft Entra admin center, go to Enterprise applications, open Hive, then open Permissions. The Admin consent tab lists each permission that is approved for your organization. Make sure that it shows all the Mail and Calendar permissions on this page.
Option 2: Use the admin consent link
Hive Support can send an admin consent link for your Microsoft tenant. The administrator does not need a Hive account for this option. The link approves every permission on Hive's Microsoft app at one time. This includes application permissions that Hive uses for organization-wide features, such as Microsoft Teams meetings and notifications. You cannot approve Mail and Calendar separately with this link.
If approval fails
The error AADSTS90094 means that administrator consent is required, and the signed-in account cannot give it. The Cloud Application Administrator and Application Administrator roles cannot approve Microsoft Graph application permissions, and Microsoft does not show them the Consent on behalf of your organization option. Use an account with the Global Administrator or Privileged Role Administrator role.
