Create Ephemeral Post

Create a temporary post only visible to a specific user in a channel.

Required Permissions: create_post_ephemeral

External Documentation

To learn more, visit the Mattermost documentation.

​

Parameters

Parameter	Description
Channel ID	The ID of the channel to post the ephemeral message in.
Message	The content of the ephemeral post. Can be formatted with Markdown format.
User ID	The ID of the user. Can be obtained from the List Users action.

​

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": "",
			"requested_ack": true,
			"persistent_notifications": true
		},
		"acknowledgements": [
			{
				"user_id": "string",
				"post_id": "string",
				"acknowledged_at": 0
			}
		]
	}
}