Calendars.ReadBasic.All | Graph Permissions

Permission Details

Application Permission

Read basic details of calendars in all mailboxes

Allows the app to read events of all calendars, except for properties such as body, attachments, and extensions, without a signed-in user.

Permission ID: 8ba4a692-bc31-4128-9094-475872af8a53

Properties

Microsoft Graph v1.0 mapped-docs

Properties is shown from stable Microsoft Graph v1.0 metadata.

Property	Type	Description
`allowedOnlineMeetingProviders`	`onlineMeetingProviderType collection`	Represent the online meeting service providers that can be used to create online meetings in this calendar. The possible values are: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.
`canEdit`	`Boolean`Nullable	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 shared a calendar and granted write access.
`canShare`	`Boolean`Nullable	true if the user has permission to share the calendar, false otherwise. Only the user who created the calendar can share it.
`canViewPrivateItems`	`Boolean`Nullable	If true, the user can read calendar items that have been marked private, false otherwise.
`changeKey`	`String`Nullable	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. The possible values are: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.
`hexColor`	`String`Nullable	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`Nullable	true if this is the default calendar where new events are created by default, false otherwise.
`isRemovable`	`Boolean`Nullable	Indicates whether this user calendar can be deleted from the user mailbox.
`isTallyingResponses`	`Boolean`Nullable	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`Nullable	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 owner property is set to the user. For a calendar shared with the user, the owner property is set to the person who shared that calendar with the user.
`calendarPermissions`	`calendarPermission collection`	The permissions of the users with whom the calendar is shared.

Showing 15 of 19 properties.

JSON Representation

Microsoft Graph v1.0 mapped-docs

JSON representation is shown from stable Microsoft Graph v1.0 metadata.

JSON representation

{
  "allowedOnlineMeetingProviders": [
    "string"
  ],
  "canEdit": "boolean",
  "canShare": "boolean",
  "canViewPrivateItems": "boolean",
  "changeKey": "string",
  "color": "String",
  "defaultOnlineMeetingProvider": "string",
  "hexColor": "String",
  "id": "string (identifier)",
  "isDefaultCalendar": "boolean",
  "isRemovable": "boolean",
  "isTallyingResponses": "boolean",
  "name": "string",
  "owner": {
    "@odata.type": "microsoft.graph.emailAddress"
  }
}

Relationships

Microsoft Graph v1.0 mapped-docs

Relationships is shown from stable Microsoft Graph v1.0 metadata.

Relationship	Type	Description
`calendarPermissions`	`calendarPermission collection`	The permissions of the users with whom the calendar is shared.
`calendarView`	`Event collection`	The calendar view for the calendar. Navigation property. Read-only.
`events`	`Event collection`	The events in the calendar. Navigation property. Read-only.
`multiValueExtendedProperties`	`multiValueLegacyExtendedProperty collection`	The collection of multi-value extended properties defined for the calendar. Read-only. Nullable.
`singleValueExtendedProperties`	`singleValueLegacyExtendedProperty collection`	The collection of single-value extended properties defined for the calendar. Read-only. Nullable.
`allowedOnlineMeetingProviders`	`array`	Represent the online meeting service providers that can be used to create online meetings in this calendar. The possible values are: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.
`owner`	`object`	If set, this represents the user who created or added the calendar. For a calendar that the user created or added, the owner property is set to the user. For a calendar shared with the user, the owner property is set to the person who shared that calendar with the user.

Graph Methods

Delegated access App-only access

No Learn or OpenAPI mapping available

Microsoft Graph v1.0 endpoints are not available from refreshed Microsoft Learn or Microsoft Graph OpenAPI metadata for this permission.

No API methods available for this version.

No Learn or OpenAPI mapping available

Microsoft Graph beta endpoints are not available from refreshed Microsoft Learn or Microsoft Graph OpenAPI metadata for this permission.

No API methods available for this version.

No Microsoft Learn PowerShell mapping available

Microsoft Graph PowerShell v1.0 commands are not available from refreshed Microsoft Learn PowerShell snippets for this permission.

No deterministic PowerShell command map is available for this permission.

Browse PowerShell docs

No Microsoft Learn PowerShell mapping available

Microsoft Graph PowerShell beta commands are not available from refreshed Microsoft Learn PowerShell snippets for this permission.

No deterministic PowerShell command map is available for this permission.

Browse PowerShell docs

Code Examples

C# / .NET SDK

using Azure.Identity;
using Microsoft.Graph;

var scopes = new[] { "Calendars.ReadBasic.All" };
var credential = new InteractiveBrowserCredential(
    new InteractiveBrowserCredentialOptions
    {
        ClientId = "YOUR_CLIENT_ID",
        TenantId = "YOUR_TENANT_ID",
        RedirectUri = new Uri("http://localhost")
    });

var graphClient = new GraphServiceClient(credential, scopes);
var response = await graphClient
    .WithUrl("https://graph.microsoft.com/v1.0/calendar")
    .GetAsync();

JavaScript

import { Client } from "@microsoft/microsoft-graph-client";
import { InteractiveBrowserCredential } from "@azure/identity";

const credential = new InteractiveBrowserCredential({
  clientId: "YOUR_CLIENT_ID",
  tenantId: "YOUR_TENANT_ID",
  redirectUri: "http://localhost"
});

const token = await credential.getToken(["Calendars.ReadBasic.All"]);
const client = Client.init({
  authProvider: (done) => done(null, token.token)
});

const response = await client.api("/calendar").get();

PowerShell

Connect-MgGraph -Scopes "Calendars.ReadBasic.All"
Invoke-MgGraphRequest -Method GET -Uri "https://graph.microsoft.com/v1.0/calendar"

Python

from azure.identity import InteractiveBrowserCredential
import requests

credential = InteractiveBrowserCredential(
    client_id="YOUR_CLIENT_ID",
    tenant_id="YOUR_TENANT_ID"
)

token = credential.get_token("Calendars.ReadBasic.All")
response = requests.get(
    "https://graph.microsoft.com/v1.0/calendar",
    headers={"Authorization": f"Bearer {token.token}"}
)

print(response.json())

App Registration

1

Navigate to Azure Portal

Go to App registrations in Microsoft Entra admin center

2

Add API Permission

Select your app → API permissions → Add a permission → Microsoft Graph

3

Select Permission Type

Choose Application permissions and search for Calendars.ReadBasic.All

4

Grant Admin Consent

Application permissions always require admin consent.