Table of Contents

Calendars.ReadBasic

Allows the app to read events in user calendars, except for properties such as body, attachments, and extensions.

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the Calendars.ReadBasic permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category Application Delegated
Identifier - 662d75ba-a364-42ad-adee-f5f880ea4878
DisplayText - Read basic details of user calendars
Description - Allows the app to read events in user calendars, except for properties such as body, attachments, and extensions.
AdminConsentRequired Yes No

Graph Methods

API supports delegated access (access on behalf of a user)
API supports app-only access (access without a user)

Methods

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

Graph reference: calendar

Property Type Description
allowedOnlineMeetingProviders onlineMeetingProviderType collection Represent the online meeting service providers that can be used to create online meetings in this calendar. Possible values are: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.
canEdit Boolean true if the user can write to the calendar, false otherwise. This property is true for the user who created the calendar. This property is also true for a user who has been shared a calendar and granted write access.
canShare Boolean true if the user has the permission to share the calendar, false otherwise. Only the user who created the calendar can share it.
canViewPrivateItems Boolean true if the user can read calendar items that have been marked private, false otherwise.
changeKey String Identifies the version of the calendar object. Every time the calendar is changed, changeKey changes as well. This allows Exchange to apply changes to the correct version of the object. Read-only.
color calendarColor Specifies the color theme to distinguish the calendar from other calendars in a UI. The property values are: auto, lightBlue, lightGreen, lightOrange, lightGray, lightYellow, lightTeal, lightPink, lightBrown, lightRed, maxColor.
defaultOnlineMeetingProvider onlineMeetingProviderType The default online meeting provider for meetings sent from this calendar. Possible values are: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.
hexColor String The calendar color, expressed in a hex color code of three hexadecimal values, each ranging from 00 to FF and representing the red, green, or blue components of the color in the RGB color space. If the user has never explicitly set a color for the calendar, this property is empty. Read-only.
id String The calendar's unique identifier. Read-only.
isDefaultCalendar Boolean true if this is the default calendar where new events are created by default, false otherwise.
isRemovable Boolean Indicates whether this user calendar can be deleted from the user mailbox.
isTallyingResponses Boolean Indicates whether this user calendar supports tracking of meeting responses. Only meeting invites sent from users' primary calendars support tracking of meeting responses.
name String The calendar name.
owner emailAddress If set, this represents the user who created or added the calendar. For a calendar that the user created or added, the **o