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
Parameter | Description |
---|---|
User ID or User Principal Name | The 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
Preview this Workflow on desktop