Skip to main content
Retrieve the list of chats that the user is part of. Please note that this action is supported only for the delegated (OAuth) method.
External DocumentationTo learn more, visit the Microsoft Teams documentation.

​
Parameters

ParameterDescription
ExpandRetrieves related resources. Possible value: members.
FilterFilters results (rows). For example: startswith(topic,‘T’)
LimitSpecify the number of chats returned per page in the response. Valid range is 1-50.
Return All PagesAutomatically fetch all resources, page by page.

​
Example Output

{
	"@odata.context": "<string>",
	"@odata.count": 248,
	"value": [
		{
			"id": "<string>",
			"topic": null,
			"createdDateTime": "2020-12-07T08:07:50",
			"lastUpdatedDateTime": "2020-11-12T09:35:18",
			"chatType": "<string>",
			"webUrl": "<string>",
			"tenantId": "<string>",
			"isHiddenForAllMembers": false,
			"onlineMeetingInfo": null,
			"viewpoint": {
				"isHidden": false,
				"lastMessageReadDateTime": "2020-04-29T03:04:53"
			}
		}
	]
}

​
Workflow Library Example

List Chats with Microsoft Teams and Send Results Via Email
Workflow LibraryPreview this Workflow on desktop