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.

External Documentation

To learn more, visit the Mattermost documentation.

​

Parameters

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. Example: { “priority”: { “priority”: “string”, “requested_ack”: true } }
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.

​

Example Output

{
	"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
			}
		]
	}
}