> ## 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 Channel Messages

List Channel Messages.

* Microsoft Graph permissions to access the action via **App Registration**: `ChannelMessage.Read.All`, `Group.Read.All`, `Group.ReadWrite.All`.

<Note>
  External Documentation

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

## Parameters

<div className="integrations-table">
  | Parameter        | Description                                                                                                                                                                                                                                                                                                                                                                          |
  | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
  | Channel ID       | The ID of the channel.<br /><br />Can be obtained by using the `List Channels` action.                                                                                                                                                                                                                                                                                               |
  | Expand           | Insert `replies` to get the properties of channel messages that are replies. By default, a response can include up to 1,000 replies.<br /><br />For more information regarding the `Expand` parameter, please refer to [Microsoft Teams' documentation](https://learn.microsoft.com/en-us/graph/api/channel-list-messages?view=graph-rest-1.0\&tabs=http#optional-query-parameters). |
  | Limit            | Specify the number of channel messages returned per page in the response. Valid range is 1-50.                                                                                                                                                                                                                                                                                       |
  | Return All Pages | Automatically fetch all resources, page by page.                                                                                                                                                                                                                                                                                                                                     |
  | Team ID          | The ID of the team.<br /><br />Can be obtained by using the `List All Teams` action.                                                                                                                                                                                                                                                                                                 |
</div>

## Example Output

```json theme={"dark"}
{
	"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('fbe2bf47-16c8-47cf-b4a5-4b9b187c508b')/channels('19%3A4a95f7d8db4c4e7fae857bcebe0623e6%40thread.tacv2')/messages",
	"@odata.count": 3,
	"@odata.nextLink": "https://graph.microsoft.com/v1.0/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/channels/19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2/messages?$skiptoken=%5b%7B%22token%22%3a%22%2bRID%3a~vpsQAJ9uAC047gwAAACcBQ%3d%3d%23RT%3a1%23TRC%3a20%23RTD%3aAyAER1ygxSHVHGAn2S99BTI6OzViOjZnOGU5ZWM1ZDVmOGdiZjk2OGNkZmNmMTczNGY3QXVpc2ZiZS91YmR3MzwyNzIyNDY2OTU0NTg6AA%3d%3d%23ISV%3a2%23IEO%3a65551%23QCF%3a3%23FPC%3aAggEAAAAcBYAABUFAADQKgAABAAAAHAWAAACALu4GwAAAHAWAAACAPSTMwAAAHAWAACaAFWa84BXgQKAEIAMgBaAE4AUgAuAAoAIwAIgACAAAiAACAABACCAAAEVgBSAI4AYgA%2bAGQAEEAAQAAEABACAAAIEEBBAACAYgB%2bAH4AbgBqACoAHwAICCBAEEIAAAgEQAACAIoAZgB2ADoAMgAKAPoAZgB2AJoAXgBIAgiAAQUqLF4AJgALACARAgBCACoAfgB6AIwABgYCQAAFXAAAAcBYAAAYA%2f50ZgGeEXwAAAHAWAAAEAPaBS4V7AAAAcBYAAAIA1aSJAAAAcBYAAAIAtLmbAAAAcBYAAAIAqKXdAAAAcBYAAAQAppUugOMAAABwFgAABADQoAWA6wAAAHAWAAAEABGl94M5AAAA0CoAAAYA6pF7iYOBaQIAANAqAAAcAEUPAMAAMAACAQCBAHQAADDAgCAAQgByAQAzUJDRBAAA0CoAAAQAETwKAA4FAADQKgAAAgBekRUFAADQKgAAHAB2pQCABYAMgJeAH4ATgAGAvIIIgASABIAFgCWA%22%2c%22range%22%3a%7B%22min%22%3a%2205C1D79B33ADE4%22%2c%22max%22%3a%2205C1D7A52F89EC%22%7D%7D%5d",
	"value": [
		{
			"id": "1616965872395",
			"replyToId": null,
			"etag": "1616965872395",
			"messageType": "message",
			"createdDateTime": "2021-03-28T21:11:12.395Z",
			"lastModifiedDateTime": "2021-03-28T21:11:12.395Z",
			"lastEditedDateTime": null,
			"deletedDateTime": null,
			"subject": null,
			"summary": null,
			"chatId": null,
			"importance": "normal",
			"locale": "en-us",
			"webUrl": "https://teams.microsoft.com/l/message/19%3A4a95f7d8db4c4e7fae857bcebe0623e6%40thread.tacv2/1616965872395?groupId=fbe2bf47-16c8-47cf-b4a5-4b9b187c508b&tenantId=2432b57b-0abd-43db-aa7b-16eadd115d34&createdTime=1616965872395&parentMessageId=1616965872395",
			"policyViolation": null,
			"eventDetail": null,
			"from": {
				"application": null,
				"device": null,
				"user": {
					"id": "8ea0e38b-efb3-4757-924a-5f94061cf8c2",
					"displayName": "Robin Kline",
					"userIdentityType": "aadUser"
				}
			},
			"body": {
				"contentType": "html",
				"content": "Hello World <at id=\"0\">Jane Smith</at>"
			},
			"channelIdentity": {
				"teamId": "fbe2bf47-16c8-47cf-b4a5-4b9b187c508b",
				"channelId": "19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2"
			},
			"attachments": [],
			"mentions": [
				{
					"id": 0,
					"mentionText": "Jane Smith",
					"mentioned": {
						"application": null,
						"device": null,
						"conversation": null,
						"user": {
							"id": "ef1c916a-3135-4417-ba27-8eb7bd084193",
							"displayName": "Jane Smith",
							"userIdentityType": "aadUser"
						}
					}
				}
			],
			"reactions": []
		},
		{
			"id": "1616963377068",
			"replyToId": null,
			"etag": "1616963377068",
			"messageType": "message",
			"createdDateTime": "2021-03-28T20:29:37.068Z",
			"lastModifiedDateTime": "2021-03-28T20:29:37.068Z",
			"lastEditedDateTime": null,
			"deletedDateTime": null,
			"subject": "",
			"summary": null,
			"chatId": null,
			"importance": "normal",
			"locale": "en-us",
			"webUrl": "https://teams.microsoft.com/l/message/19%3A4a95f7d8db4c4e7fae857bcebe0623e6%40thread.tacv2/1616963377068?groupId=fbe2bf47-16c8-47cf-b4a5-4b9b187c508b&tenantId=2432b57b-0abd-43db-aa7b-16eadd115d34&createdTime=1616963377068&parentMessageId=1616963377068",
			"policyViolation": null,
			"eventDetail": null,
			"from": {
				"application": null,
				"device": null,
				"user": {
					"id": "8ea0e38b-efb3-4757-924a-5f94061cf8c2",
					"displayName": "Robin Kline",
					"userIdentityType": "aadUser"
				}
			},
			"body": {
				"contentType": "html",
				"content": "<div><div><div><span><img height=\"145\" src=\"https://graph.microsoft.com/v1.0/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/channels/19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2/messages/1616963377068/hostedContents/aWQ9eF8wLXd1cy1kMS02YmI3Nzk3ZGU2MmRjODdjODA4YmQ1ZmI0OWM4NjI2ZCx0eXBlPTEsdXJsPWh0dHBzOi8vdXMtYXBpLmFzbS5za3lwZS5jb20vdjEvb2JqZWN0cy8wLXd1cy1kMS02YmI3Nzk3ZGU2MmRjODdjODA4YmQ1ZmI0OWM4NjI2ZC92aWV3cy9pbWdv/$value\" width=\"131\" style=\"vertical-align:bottom; width:131px; height:145px\"></span><div>&nbsp;</div></div><div><div><span><img height=\"65\" src=\"https://graph.microsoft.com/v1.0/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/channels/19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2/messages/1616963377068/hostedContents/aWQ9eF8wLXd1cy1kNi0xMzY3OTE4MzVlODIxOGZlMmUwZWEwYTA1ODAxNjRiNCx0eXBlPTEsdXJsPWh0dHBzOi8vdXMtYXBpLmFzbS5za3lwZS5jb20vdjEvb2JqZWN0cy8wLXd1cy1kNi0xMzY3OTE4MzVlODIxOGZlMmUwZWEwYTA1ODAxNjRiNC92aWV3cy9pbWdv/$value\" width=\"79\" style=\"vertical-align:bottom; width:79px; height:65px\"></span></div></div></div></div>"
			},
			"channelIdentity": {
				"teamId": "fbe2bf47-16c8-47cf-b4a5-4b9b187c508b",
				"channelId": "19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2"
			},
			"attachments": [],
			"mentions": [],
			"reactions": []
		},
		{
			"id": "1616883610266",
			"replyToId": null,
			"etag": "1616883610266",
			"messageType": "unknownFutureValue",
			"createdDateTime": "2021-03-28T03:50:10.266Z",
			"lastModifiedDateTime": "2021-03-28T03:50:10.266Z",
			"lastEditedDateTime": null,
			"deletedDateTime": null,
			"subject": null,
			"summary": null,
			"chatId": null,
			"importance": "normal",
			"locale": "en-us",
			"webUrl": "https://teams.microsoft.com/l/message/19%3A4a95f7d8db4c4e7fae857bcebe0623e6%40thread.tacv2/1616883610266?groupId=fbe2bf47-16c8-47cf-b4a5-4b9b187c508b&tenantId=2432b57b-0abd-43db-aa7b-16eadd115d34&createdTime=1616883610266&parentMessageId=1616883610266",
			"policyViolation": null,
			"from": null,
			"body": {
				"contentType": "html",
				"content": "<systemEventMessage/>"
			},
			"channelIdentity": {
				"teamId": "fbe2bf47-16c8-47cf-b4a5-4b9b187c508b",
				"channelId": "19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2"
			},
			"attachments": [],
			"mentions": [],
			"reactions": [],
			"eventDetail": {
				"@odata.type": "#microsoft.graph.teamDescriptionUpdatedEventMessageDetail",
				"teamId": "fbe2bf47-16c8-47cf-b4a5-4b9b187c508b",
				"teamDescription": "Team for Microsoft Teams members",
				"initiator": {
					"application": null,
					"device": null,
					"user": {
						"id": "1fb8890f-423e-4154-8fbf-db6809bc8756",
						"displayName": null,
						"userIdentityType": "aadUser"
					}
				}
			}
		}
	]
}
```

## Workflow Library Example

[List Channel Messages with Microsoft Teams and Send Results Via Email](https://library.blinkops.com/workflows/list-channel-messages-with-microsoft-teams-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-channel-messages-with-microsoft-teams-and-send-results-via-email/canvas" />
</div>