> ## 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 Posts

List posts in a channel.

**Required Permissions**: `read_channel` for this specific channel.

<Note>
  External Documentation

  To learn more, visit the [Mattermost documentation](https://developers.mattermost.com/api-documentation/#/operations/GetPostsForChannel).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter        | Description                                                                                                        |
  | ---------------- | ------------------------------------------------------------------------------------------------------------------ |
  | After            | The ID of a post used to filter results that were created after this post.                                         |
  | Before           | The ID of a post used to filter results that were created before this post.                                        |
  | Channel ID       | The ID of the channel. Can be obtained from the `List All Channels` action.                                        |
  | Include Deleted  | Select to include deleted posts.<br /><br />**Note:** System admin permissions are required to use this parameter. |
  | Page             | The page number to retrieve, starting at `0`.                                                                      |
  | Per Page         | The maximum number of items to retrieve per page.                                                                  |
  | Return All Pages | Automatically fetch all resources, page by page.                                                                   |
  | Since            | The date and time to filter results that were created after this timestamp.                                        |
  | Type             | The type of the post to filter results by.                                                                         |
</div>

## Example Output

```json theme={"dark"}
{
	"order": [
		"post_id1",
		"post_id12"
	],
	"posts": {
		"property1": {
			"id": "string",
			"create_at": 0,
			"update_at": 0,
			"delete_at": 0,
			"edit_at": 0,
			"user_id": "string",
			"channel_id": "string",
			"root_id": "string",
			"original_id": "string",
			"message": "string",
			"type": "string",
			"props": {},
			"hashtag": "string",
			"file_ids": [
				"string"
			],
			"pending_post_id": "string",
			"metadata": {
				"embeds": [
					{
						"type": "image",
						"url": "string",
						"data": {}
					}
				],
				"emojis": [
					{
						"id": "string",
						"creator_id": "string",
						"name": "string",
						"create_at": 0,
						"update_at": 0,
						"delete_at": 0
					}
				],
				"files": [
					{
						"id": "string",
						"user_id": "string",
						"post_id": "string",
						"create_at": 0,
						"update_at": 0,
						"delete_at": 0,
						"name": "string",
						"extension": "string",
						"size": 0,
						"mime_type": "string",
						"width": 0,
						"height": 0,
						"has_preview_image": true
					}
				],
				"images": {},
				"reactions": [
					{
						"user_id": "string",
						"post_id": "string",
						"emoji_name": "string",
						"create_at": 0
					}
				],
				"priority": {
					"priority": "string",
					"requested_ack": true
				},
				"acknowledgements": [
					{
						"user_id": "string",
						"post_id": "string",
						"acknowledged_at": 0
					}
				]
			}
		},
		"property2": {
			"id": "string",
			"create_at": 0,
			"update_at": 0,
			"delete_at": 0,
			"edit_at": 0,
			"user_id": "string",
			"channel_id": "string",
			"root_id": "string",
			"original_id": "string",
			"message": "string",
			"type": "string",
			"props": {},
			"hashtag": "string",
			"file_ids": [
				"string"
			],
			"pending_post_id": "string",
			"metadata": {
				"embeds": [
					{
						"type": "image",
						"url": "string",
						"data": {}
					}
				],
				"emojis": [
					{
						"id": "string",
						"creator_id": "string",
						"name": "string",
						"create_at": 0,
						"update_at": 0,
						"delete_at": 0
					}
				],
				"files": [
					{
						"id": "string",
						"user_id": "string",
						"post_id": "string",
						"create_at": 0,
						"update_at": 0,
						"delete_at": 0,
						"name": "string",
						"extension": "string",
						"size": 0,
						"mime_type": "string",
						"width": 0,
						"height": 0,
						"has_preview_image": true
					}
				],
				"images": {},
				"reactions": [
					{
						"user_id": "string",
						"post_id": "string",
						"emoji_name": "string",
						"create_at": 0
					}
				],
				"priority": {
					"priority": "string",
					"requested_ack": true
				},
				"acknowledgements": [
					{
						"user_id": "string",
						"post_id": "string",
						"acknowledged_at": 0
					}
				]
			}
		}
	},
	"next_post_id": "string",
	"prev_post_id": "string",
	"has_next": true
}
```

## Workflow Library Example

[List Channel Posts with Mattermost and Send Results Via Email](https://library.blinkops.com/workflows/list-channel-posts-with-mattermost-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-posts-with-mattermost-and-send-results-via-email/canvas" />
</div>