Calendars.ReadWrite.All

Allows the app to read, create, update, and delete work hours and locations settings, recurrences, and occurrences for all users in the organization, without a signed-in user.

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.ReadWrite.All 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	d91697b0-a708-4c11-a712-8fb2dc081aa2	-
DisplayText	Read and write all users' work hours and locations	-
Description	Allows the app to read, create, update, and delete work hours and locations settings, recurrences, and occurrences for all users in the organization, without a signed-in user.	-
AdminConsentRequired	-	-

Graph Methods

• API [v1.0]
• API [beta]
• PowerShell [v1.0]
• PowerShell [beta]

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

	Methods
	GET /me/settings/workHoursAndLocations/occurrencesView(startDateTime='{startDateTime}',endDateTime='{endDateTime}')

Resources

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

• workPlanOccurrence

Graph reference: workPlanOccurrence

Property	Type	Description
end	dateTimeTimeZone	The end date and time for this occurrence.
id	String	Unique identifier for the occurrence.
placeId	String	Identifier of a place from the Microsoft Graph Places Directory API. Only applicable when workLocationType is set to office.
recurrenceId	String	The identifier of the parent recurrence pattern that generated this occurrence. The value is null for time-off occurrences because they don't have a parent recurrence.
start	dateTimeTimeZone	The start date and time for this occurrence.
timeOffDetails	timeOffDetails	The details about the time off. Only applicable when workLocationType is set to timeOff.
workLocationType	workLocationType	The type of work location. The possible values are: unspecified, office, remote, timeOff, unknownFutureValue.