Skip to main content
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 DocumentationTo learn more, visit the Mattermost documentation.

​
Parameters

ParameterDescription
Channel IDThe ID of the channel. Can be obtained from the List All Channels action.
File IDsA comma-separated list of file IDs to attach to the post.
MessageThe content of the post. The post can be plain text or formatted using Markdown format.
MetadataA JSON object of additional post metadata.

Example:
{
  “priority”: {
    “priority”: “string”,
    “requested_ack”: true
  }
}
PropsA JSON object of additional post properties.
Root IDThe ID of the parent post to reply to. When provided, the post is posted as a comment in the parent post’s thread.
Set OnlineSelect 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
			}
		]
	}
}

​
Workflow Library Example

Create Post in Channel with Mattermost and Send Results Via Email
Workflow LibraryPreview this Workflow on desktop