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

# Create Post In Channel

Create a post to a channel.

**Note:** To create the post as a comment on another post use the `Root ID` parameter.

**Required Permissions**: `create_post` for the channel the post is being created into.

<Note>
  External Documentation

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

## Parameters

<div className="integrations-table">
  | Parameter  | Description                                                                                                                                                                                             |
  | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Channel ID | The ID of the channel. Can be obtained from the `List All Channels` action.                                                                                                                             |
  | File IDs   | A comma-separated list of file IDs to attach to the post.                                                                                                                                               |
  | Message    | The content of the post. The post can be plain text or formatted using Markdown format.                                                                                                                 |
  | Metadata   | A JSON object of additional post metadata.<br /><br />**Example**:<br /><pre><code>\{<br />  "priority": \{<br />    "priority": "string",<br />    "requested\_ack": true<br />  }<br />}</code></pre> |
  | Props      | A JSON object of additional post properties.                                                                                                                                                            |
  | Root ID    | The ID of the parent post to reply to. When provided, the post is posted as a comment in the parent post's thread.                                                                                      |
  | Set Online | Select to set the user status as online when the post is sent.                                                                                                                                          |
</div>

## Example Output

```json theme={"dark"}
{
	"id": "string",
	"create_at": -9007199254740991,
	"update_at": -9007199254740991,
	"delete_at": -9007199254740991,
	"edit_at": -9007199254740991,
	"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
			}
		]
	}
}
```

## Workflow Library Example

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