Permissions
Under “API Permissions” click Add a permission, then Microsoft Graph, then Delegated permission, and add the permissions as detailed in the list and table below:
- Calendar - For calendars Note the requirement for
.Shared
permissions for shared mailbox calendars - Email - For an email_sensor or a query_sensor Note the requirement for
.Shared
permissions for shared mailboxes - Status - For a status_sensor
- Chat - For a chat_sensor
- ToDo - For a todo_sensor
- Group Calendar - For a manually added Group calendar
- AutoReply - For Auto reply/Out of Office message configuration
If you intend to send emails use calendar update functionality, then set enable_update at the top level to true
. For other sensors set enable_update to true for each sensor supporting it. Then for any sensor type, add the relevant ReadWrite
permission as denoted by a Y
in the update column.
Feature | Permissions | Update | O365 Description | Notes |
---|---|---|---|---|
Calendar | offline_access | Maintain access to data you have given it access to | ||
Calendar | Calendars.ReadBasic | Read basic details of user calendars | Used when basic_calendar is set to true | |
Calendar | Calendars.Read | Read user calendars | ||
Calendar | Calendars.ReadWrite | Y | Read and write user calendars | |
Calendar | Calendars.Read.Shared | Read user and shared calendars | For shared mailboxes | |
Calendar | Calendars.ReadWrite.Shared | Y | Read and write user and shared calendars | For shared mailboxes |
Calendar | User.Read | Sign in and read user profile | ||
Mail.Read | Read access to user mail | |||
Mail.Send | Y | Send mail as a user | ||
Mail.Read.Shared | Read user and shared mail | For shared mailboxes | ||
Mail.Send.Shared | Y | Send mail on behalf of others | For shared mailboxes | |
Status | Presence.Read | Read user’s presence information | Not for personal accounts/shared mailboxes | |
Status | Presence.ReadWrite | Y | Read and write a user’s presence information | Not for personal accounts/shared mailboxes |
Status | Presence.Read.All | Read presence information of all users in your organization | Used if you want to monitor another user’s status. Not for personal accounts/shared mailboxes | |
Chat | Chat.Read | Read user chat messages | Not for personal accounts/shared mailboxes | |
Chat | Chat.ReadWrite | Y | Read and write user chat messages | Not for personal accounts/shared mailboxes |
ToDo | Tasks.Read | Read user’s tasks and task lists | Not for shared mailboxes | |
ToDo | Tasks.ReadWrite | Y | Create, read, update, and delete user’s tasks and task lists | Not for shared mailboxes |
Group Calendar | Group.Read.All | Read all groups | Not supported in shared mailboxes | |
Group Calendar | Group.ReadWrite.All | Y | Read and write all groups | Not supported in shared mailboxes |
AutoReply | MailboxSettings.ReadWrite | Read and write user mailbox settings | Not for shared mailboxes |
Note It should be noted that these are the permissions that are requested at authentication time (as appropriate for each sensor configured). When enable_update
is configured to true
all the associated ReadWrite
permissions are requested as well, however you do not need to add ReadWrite
for any sensor type where you do not what update permissions, it will still act as a Read Only sensor. This excludes the AutoReply option which is only ReadWrite
.
For example, permissions as below (and with enable_update
set to true
) will create calendar sensors, create chat sensors, and create auto reply enable/disable services but will not enable create/modify/remove/respond services:
"scope": [
"Calendars.Read",
"Chat.Read",
"MailboxSettings.ReadWrite",
"User.Read",
]
Changing Features and Permissions
If you decide to enable new features in the integration, or decide to change from read only to read/write, you will very likely get a warning message similar to the following in your logs.
Minimum required permissions not granted: ['Tasks.Read', ['Tasks.ReadWrite']]
You will need to delete as detailed on the token page