upstream-mattermost/docs/develop/integrate/reference/message-priority/index.md

title, description, sidebar_label, sidebar_position

title	description	sidebar_label	sidebar_position
Use message priority	Set message priority levels so users can identify important messages and optionally request acknowledgments or persistent notifications.	Message priority	50

Messages can be sent with a priority level to help users identify the importance of the message. For more information about message priority, see formatting text.

Priority options

When sending a message, you can use any of the following to format how you want the posted message to look.

priority: A required plain-text summary of the message. This is used in notifications, and in clients that don’t support formatted text (e.g. IRC).

requested_ack: If set to true, the message will be marked as requiring an acknowledgment from the users by displaying a checkmark icon next to the message. Keep in mind that this requires the message priority to be set to Important or Urgent.

persistent_notifications: Only for Urgent messages. If set to true recipients will receive a persistent notification every five minutes until they acknowledge the message. Mutually exclusive with the silent field on incoming webhooks — a post cannot be both persistent and silent.

Example of post priority

{
    "priority": {
        "priority": "urgent",
    }
}

And this is how it renders on Mattermost:

Example of post priority with requested acknowledgment

{
    "priority": {
        "priority": "important",
        "requested_ack": true
    }
}

And this is how it renders on Mattermost:

Related documentation

• Message priority
• CreatePost API