Skip to main content

List User Calendars

Retrieve a list of events in a calendar. The calendar can be one for a user. The list of events contains single instance meetings and series masters. To get expanded event instances, you can get the calendar view, or get the instances of an event.

  • Least privileged Microsoft Graph permission to access the action via application: Calendars.ReadBasic.
  • Higher privileged Microsoft Graph permissions to access the action via application: Calendars.ReadWrite, Calendars.Read.
Note: Using the delegated (OAuth) connection type will only allow to insert the connected user's ID.
External Documentation

To learn more, visit the Microsoft Outlook documentation.

Parameters

ParameterDescription
User ID or User Principal NameThe ID or userPrincipalName of the user.

Example Output

{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#me/calendars",
"value": [
{
"@odata.id": "https://graph.microsoft.com/v1.0/users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/calendars('AAMkAGI2TGuLAAA=')",
"id": "AAMkAGI2TGuLAAA=",
"name": "Calendar",
"color": "auto",
"changeKey": "nfZyf7VcrEKLNoU37KWlkQAAA0x0+w==",
"canShare": true,
"canViewPrivateItems": true,
"hexColor": "",
"canEdit": true,
"allowedOnlineMeetingProviders": [
"teamsForBusiness"
],
"defaultOnlineMeetingProvider": "teamsForBusiness",
"isTallyingResponses": true,
"isRemovable": false,
"owner": {
"name": "Samantha Booth",
"address": "samanthab@adatum.onmicrosoft.com"
}
}
]
}

Workflow Library Example

List User Calendars with Microsoft Outlook and Send Results Via Email

Workflow LibraryPreview this Workflow on desktop