> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.
```

<Note>
  External Documentation

  To learn more, visit the [Microsoft Outlook documentation](https://learn.microsoft.com/en-us/graph/api/user-list-calendars?view=graph-rest-1.0\&tabs=http).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter                      | Description                                      |
  | ------------------------------ | ------------------------------------------------ |
  | Limit                          | Set the page size of the returned results.       |
  | Return All Pages               | Automatically fetch all resources, page by page. |
  | User ID or User Principal Name | The ID or userPrincipalName of the user.         |
</div>

## Example Output

```json theme={"dark"}
{
	"@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](https://library.blinkops.com/workflows/list-user-calendars-with-microsoft-outlook-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/list-user-calendars-with-microsoft-outlook-and-send-results-via-email/canvas" />
</div>