Server messages
Actions in the category "Server messages".
Send message
Sends a message to a channel.
Required permissions: View channel, Send messages.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Channel | Text channel | Yes | Channel to send the message to. |
| Message | Message content | Yes | Content of the message. |
Outputs
| Name | Type | Details |
|---|---|---|
| Sent message | Message | The message that was sent. |
Send paginated message
Sends a message with prev/next buttons that page through a list of message contents. The page state is stored durably, so paging keeps working after a bot restart.
Required permissions: View channel, Send messages.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Channel | Text channel | Yes | Channel to send the paginated message to. |
| Pages | List of Message content | Yes | The list of pages (message contents) to page through, e.g. built with Create message pages and Add message page. Max 100. Maximum items: 100. |
| Restrict to user | User | No | By default, only the user who triggered the flow can page through the message. Set a user here to lock paging to someone else instead. On flows with no triggering user (e.g. scheduled or automatic flows), anyone can page. |
| Timeout | Duration | No | How long the buttons stay active before the paginated message expires. Defaults to 24 hours; capped at 7 days. Value: 60000 to 604800000. |
Outputs
| Name | Type | Details |
|---|---|---|
| Sent message | Message | The paginated message that was sent. |
Reply to message
Sends a message as a reply to another message.
Required permissions: View channel, Send messages, Read message history.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Target message | Message | Yes | Message to reply to. |
| Message | Message content | Yes | Content of the reply. |
| Fail if missing | Yes/No | Yes | Fail the action if the target message has been deleted. Default: Yes. |
Outputs
| Name | Type | Details |
|---|---|---|
| Sent message | Message | The reply that was sent. |
Edit message
Edits an existing message sent by the bot.
Required permissions: View channel.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message | Yes | Message to edit. |
| New content | Message content | Yes | New content for the message. |
Outputs
| Name | Type | Details |
|---|---|---|
| Updated message | Message | The message after the edit. |
Delete message
Deletes a message.
Required permissions: Manage messages.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message | Yes | Message to delete. |
| Audit log reason | Text | No | Reason recorded in the audit log. Maximum length: 512 characters. |
React to message
Adds a reaction to a message.
Required permissions: Read message history, Add reactions.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message | Yes | Message to react to. |
| Emoji | Text | Yes | Emoji to add. Use a unicode emoji or the format <:name:id> for a custom emoji. |
Show bot as typing
Show the bot as typing in a channel for about 10 seconds.
Required permissions: View channel.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Channel | Channel | Yes | Channel in which to display the typing indicator. |
Bulk delete messages
Delete up to 100 recent messages from a text channel in a single API call. Messages older than 14 days cannot be bulk deleted.
Required permissions: Manage messages.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Channel | Text channel | Yes | Channel to clear messages from. |
| Count | Whole number | No | Number of recent messages to delete (2-100). Value: 2 to 100. Use only one of these: Messages. |
| Messages | List of Message | No | Specific messages to delete (1-100). Items: 1 to 100. Use only one of these: Count. |
| Filter Old Messages | Yes/No | No | Skip messages older than 14 days instead of erroring. Default: Yes. |
Outputs
| Name | Type | Details |
|---|---|---|
| Deleted Count | Whole number | Number of messages that were actually deleted. |
Fetch channel messages
Retrieve messages from a text-like channel. Use only one of before/after/around.
Required permissions: View channel, Read message history.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Channel | Text channel | Yes | Channel to read messages from. |
| Limit | Whole number | No | How many messages to fetch (1-100). Value: 1 to 100. Default: 50. |
| Before | Message | No | Fetch messages older than this message. Use only one of these: After, Around. |
| After | Message | No | Fetch messages newer than this message. Use only one of these: Before, Around. |
| Around | Message | No | Fetch messages around this message. Use only one of these: Before, After. |
Outputs
| Name | Type | Details |
|---|---|---|
| Messages | List of Message | The fetched messages. |
Fetch message by ID
Look up a single message in a channel by its ID. Returns an empty value if the message does not exist.
Required permissions: View channel, Read message history.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Channel | Text channel | Yes | Channel that owns the message. |
| Message ID | Discord ID | Yes | ID of the message to fetch. |
| Force Refresh | Yes/No | No | Bypass the cache and request fresh data from Discord. Default: No. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message | The fetched message, or empty if not found. May be empty. |
Fetch pinned messages
Retrieve all pinned messages in a channel.
Required permissions: View channel, Read message history.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Channel | Text channel | Yes | Channel to inspect. |
Outputs
| Name | Type | Details |
|---|---|---|
| Messages | List of Message | All currently pinned messages. |
Pin message
Pins a message in its channel so it appears in the pinned-messages list.
Required permissions: Manage messages.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message | Yes | The message to pin. |
| Audit Log Reason | Text | No | Optional reason recorded in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message | The pinned message. |
Unpin message
Removes a message from its channel's pinned-messages list.
Required permissions: Manage messages.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message | Yes | The message to unpin. |
| Audit Log Reason | Text | No | Optional reason recorded in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message | The unpinned message. |
Crosspost message
Publishes a message from an announcement channel to all servers that follow it.
Required permissions: Send messages, Manage messages.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message | Yes | The announcement-channel message to crosspost. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message | The crossposted message. |
Suppress embeds on message
Hides or restores embeds on an existing message without deleting it.
Required permissions: Manage messages.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message | Yes | The message whose embeds should be toggled. |
| Suppress | Yes/No | No | If true, hides embeds; if false, makes them visible again. Default: Yes. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message | The updated message. |
Forward message
Forwards an existing message into another channel using Discord's native forward feature.
Required permissions: Send messages.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message | Yes | The message to forward. |
| Target Channel | Server channel | Yes | The channel that will receive the forwarded message. |
Outputs
| Name | Type | Details |
|---|---|---|
| Forwarded Message | Message | The newly created forwarded message. |
Fetch message reference
Returns the message that another message replied to or referenced, if any.
Required permissions: Read message history.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message | Yes | The message whose reference should be fetched. |
Outputs
| Name | Type | Details |
|---|---|---|
| Referenced Message | Message | The message that was replied to, or empty if none. May be empty. |
Send direct message
Sends a direct message to a Discord user.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Recipient | User | Yes | The user who should receive the DM. |
| Content | Message content | Yes | Message content, embeds, components and files to send. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message | The sent direct message. |
Remove own reaction
Removes a reaction the bot itself added to a message.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message | Yes | The message to remove the reaction from. |
| Emoji | Text | Yes | Unicode emoji or custom emoji identifier to remove. |
Remove user reaction
Removes a specific user's reaction of a given emoji from a message.
Required permissions: Manage messages.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message | Yes | The message containing the reaction. |
| Emoji | Text | Yes | Unicode emoji or custom emoji identifier to remove. |
| User | User | Yes | The user whose reaction will be removed. |
Remove all reactions
Removes every reaction from a message, regardless of emoji or user.
Required permissions: Manage messages.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message | Yes | The message whose reactions should be cleared. |
Remove all reactions of emoji
Removes every reaction of a single emoji from a message, across all users.
Required permissions: Manage messages.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message | Yes | The message containing the reactions. |
| Emoji | Text | Yes | The emoji whose reactions will be cleared. |
Fetch reaction users
Returns the users who reacted to a message with a specific emoji.
Required permissions: Read message history.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message | Yes | The message whose reactions should be queried. |
| Emoji | Text | Yes | The emoji whose reactors should be fetched. |
| Limit | Whole number | No | Maximum number of users to fetch (1-100). Value: 1 to 100. Default: 100. |
Outputs
| Name | Type | Details |
|---|---|---|
| Users | List of User | Users who reacted with the given emoji. |
Create empty embed
Create a new, blank embed with no fields set. Use the setter actions to fill it in.
Outputs
| Name | Type | Details |
|---|---|---|
| Embed | Embed | The freshly created empty embed. |
Create embed
Create a new embed with optional title, description, and color in a single step.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Title | Text | No | Embed title shown at the top. Maximum length: 256 characters. |
| Description | Text | No | Body text shown below the title. Maximum length: 4096 characters. |
| Color | Color | No | Side bar color of the embed. |
Outputs
| Name | Type | Details |
|---|---|---|
| Embed | Embed | The newly created embed. |
Set embed title
Return a copy of the embed with its title replaced. Pass nothing to remove the title.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to modify. |
| Title | Text | No | New title, or empty to clear it. Maximum length: 256 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Embed | Embed | Updated embed. |
Set embed description
Return a copy of the embed with its description replaced.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to modify. |
| Description | Text | No | New description, or empty to clear it. Maximum length: 4096 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Embed | Embed | Updated embed. |
Set embed URL
Return a copy of the embed with the title hyperlink set to the given URL.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to modify. |
| URL | URL | Yes | URL the title links to. |
Outputs
| Name | Type | Details |
|---|---|---|
| Embed | Embed | Updated embed. |
Set embed color
Return a copy of the embed with the side bar color replaced.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to modify. |
| Color | Color | Yes | New side bar color. |
Outputs
| Name | Type | Details |
|---|---|---|
| Embed | Embed | Updated embed. |
Set embed timestamp
Return a copy of the embed with its footer timestamp set. When omitted, the current time is used.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to modify. |
| Timestamp | Date and time | No | Timestamp to display, or leave empty for now. |
Outputs
| Name | Type | Details |
|---|---|---|
| Embed | Embed | Updated embed. |
Set embed image
Return a copy of the embed with its large image replaced.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to modify. |
| Image URL | URL | Yes | URL of the large image displayed at the bottom of the embed. |
Outputs
| Name | Type | Details |
|---|---|---|
| Embed | Embed | Updated embed. |
Set embed thumbnail
Return a copy of the embed with its top right thumbnail replaced.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to modify. |
| Thumbnail URL | URL | Yes | URL of the small thumbnail image. |
Outputs
| Name | Type | Details |
|---|---|---|
| Embed | Embed | Updated embed. |
Set embed author
Return a copy of the embed with the small author line above the title replaced.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to modify. |
| Author name | Text | No | Name shown in the author line. Maximum length: 256 characters. Use only one of these: Author. |
| Author URL | URL | No | Optional URL the author name links to. |
| Author icon URL | URL | No | Optional small icon shown next to the author name. |
| Author | Embed author | No | A prebuilt author value to use instead of the name/URL/icon fields above. Use only one of these: Author name. |
Outputs
| Name | Type | Details |
|---|---|---|
| Embed | Embed | Updated embed. |
Clear embed author
Return a copy of the embed with the author line removed.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to modify. |
Outputs
| Name | Type | Details |
|---|---|---|
| Embed | Embed | Updated embed without an author line. |
Set embed footer
Return a copy of the embed with the footer text and optional icon replaced.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to modify. |
| Footer text | Text | No | Footer text shown at the bottom. Maximum length: 2048 characters. Use only one of these: Footer. |
| Footer icon URL | URL | No | Optional small icon next to the footer text. |
| Footer | Embed footer | No | A prebuilt footer value to use instead of the text/icon fields above. Use only one of these: Footer text. |
Outputs
| Name | Type | Details |
|---|---|---|
| Embed | Embed | Updated embed. |
Clear embed footer
Return a copy of the embed with the footer removed.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to modify. |
Outputs
| Name | Type | Details |
|---|---|---|
| Embed | Embed | Updated embed without a footer. |
Add embed field
Return a copy of the embed with a new field appended. Discord allows at most 25 fields per embed.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to modify. |
| Field name | Text | Yes | Bold heading text of the field. Maximum length: 256 characters. |
| Field value | Text | Yes | Body text of the field. Maximum length: 1024 characters. |
| Inline | Yes/No | Yes | If true, the field is displayed next to other inline fields. Default: No. |
Outputs
| Name | Type | Details |
|---|---|---|
| Embed | Embed | Updated embed. |
Remove embed field at index
Return a copy of the embed with the field at the given zero-based index removed.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to modify. |
| Index | Whole number | Yes | Zero-based position of the field to remove. Minimum: 0. |
Outputs
| Name | Type | Details |
|---|---|---|
| Embed | Embed | Updated embed. |
Clear embed fields
Return a copy of the embed with all fields removed.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to modify. |
Outputs
| Name | Type | Details |
|---|---|---|
| Embed | Embed | Updated embed without any fields. |
Set embed fields
Return a copy of the embed with its fields replaced by the given list. Discord allows at most 25.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to modify. |
| Fields | List of Embed field | Yes | Replacement list of embed fields. Maximum items: 25. |
Outputs
| Name | Type | Details |
|---|---|---|
| Embed | Embed | Updated embed. |
Get embed title
Read the title from an embed. Returns nothing when no title is set.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to read. |
Outputs
| Name | Type | Details |
|---|---|---|
| Title | Text | The embed's title or empty. May be empty. |
Get embed description
Read the description from an embed. Returns nothing when no description is set.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to read. |
Outputs
| Name | Type | Details |
|---|---|---|
| Description | Text | The embed's description or empty. May be empty. |
Get embed color
Read the side bar color from an embed. Returns nothing when no color is set.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to read. |
Outputs
| Name | Type | Details |
|---|---|---|
| Color | Color | The embed's side bar color or empty. May be empty. |
Get embed fields
Read the list of fields from an embed.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to read. |
Outputs
| Name | Type | Details |
|---|---|---|
| Fields | List of Embed field | All fields currently on the embed. |
Get embed author name
Read the author name shown above the embed title.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to read. |
Outputs
| Name | Type | Details |
|---|---|---|
| Author name | Text | The author name or empty if no author is set. May be empty. |
Get embed footer text
Read the footer text shown at the bottom of an embed.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to read. |
Outputs
| Name | Type | Details |
|---|---|---|
| Footer text | Text | The footer text or empty if no footer is set. May be empty. |
Get embed URL
Read the title hyperlink URL from an embed. Returns nothing when no URL is set.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to read. |
Outputs
| Name | Type | Details |
|---|---|---|
| URL | URL | The embed's title hyperlink URL or empty. May be empty. |
Get embed timestamp
Read the footer timestamp from an embed. Returns nothing when no timestamp is set.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to read. |
Outputs
| Name | Type | Details |
|---|---|---|
| Timestamp | Date and time | The embed's timestamp or empty. May be empty. |
Get embed image
Read the large image URL from an embed. Returns nothing when no image is set.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to read. |
Outputs
| Name | Type | Details |
|---|---|---|
| Image URL | URL | URL of the large image or empty if no image is set. May be empty. |
Get embed thumbnail
Read the top right thumbnail URL from an embed. Returns nothing when no thumbnail is set.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to read. |
Outputs
| Name | Type | Details |
|---|---|---|
| Thumbnail URL | URL | URL of the small thumbnail image or empty if no thumbnail is set. May be empty. |
Get embed author URL
Read the URL the author name links to. Returns nothing when no author URL is set.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to read. |
Outputs
| Name | Type | Details |
|---|---|---|
| Author URL | URL | The author link URL or empty if none is set. May be empty. |
Get embed author icon
Read the small icon shown next to the author name. Returns nothing when no author icon is set.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to read. |
Outputs
| Name | Type | Details |
|---|---|---|
| Author icon URL | URL | URL of the author icon or empty if none is set. May be empty. |
Get embed footer icon
Read the small icon shown next to the footer text. Returns nothing when no footer icon is set.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Embed | Embed | Yes | Embed to read. |
Outputs
| Name | Type | Details |
|---|---|---|
| Footer icon URL | URL | URL of the footer icon or empty if none is set. May be empty. |
Create embed field
Build a single embed field value to be passed to other actions.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Field name | Text | Yes | Bold heading text of the field. Maximum length: 256 characters. |
| Field value | Text | Yes | Body text of the field. Maximum length: 1024 characters. |
| Inline | Yes/No | Yes | If true, the field can sit next to other inline fields. Default: No. |
Outputs
| Name | Type | Details |
|---|---|---|
| Field | Embed field | The constructed embed field. |
Create embed footer
Build a footer value to be assigned to an embed.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Footer text | Text | Yes | Footer text. Maximum length: 2048 characters. |
| Footer icon URL | URL | No | Optional icon shown next to the text. |
Outputs
| Name | Type | Details |
|---|---|---|
| Footer | Embed footer | The constructed footer. |
Create embed author
Build an author value to be assigned to an embed.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Name | Text | Yes | Author display name. Maximum length: 256 characters. |
| URL | URL | No | Optional URL the author name links to. |
| Icon URL | URL | No | Optional small icon next to the author name. |
Outputs
| Name | Type | Details |
|---|---|---|
| Author | Embed author | The constructed author. |
Create button
Build a button. Provide a target flow for normal buttons, or a URL for link buttons.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Label | Text | No | Text shown on the button. Maximum length: 80 characters. |
| Style | Button style | Yes | Visual style of the button. Default: Primary (blue) |
| Custom ID | Text | No | Optional identifier that rides along with the click (max 80 characters). Maximum length: 80 characters. |
| Target flow | Flow | No | Flow to run when the button is clicked. |
| URL | URL | No | URL opened by a link button. |
| Emoji | Text | No | Emoji shown alongside the label. |
| Disabled | Yes/No | Yes | If true, the button is shown but not clickable. Default: No. |
Outputs
| Name | Type | Details |
|---|---|---|
| Button | Button | The constructed button. |
Set button label
Return a copy of the button with its label replaced.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Button | Button | Yes | Button to modify. |
| Label | Text | Yes | New button label. Maximum length: 80 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Button | Button | Updated button. |
Set button emoji
Return a copy of the button with its emoji replaced.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Button | Button | Yes | Button to modify. |
| Emoji | Text | Yes | New emoji shown on the button. |
Outputs
| Name | Type | Details |
|---|---|---|
| Button | Button | Updated button. |
Set button style
Return a copy of the button with its visual style replaced.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Button | Button | Yes | Button to modify. |
| Style | Button style | Yes | New visual style. |
Outputs
| Name | Type | Details |
|---|---|---|
| Button | Button | Updated button. |
Set button disabled state
Return a copy of the button enabled or disabled.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Button | Button | Yes | Button to modify. |
| Disabled | Yes/No | Yes | If true, the button is greyed out and unclickable. |
Outputs
| Name | Type | Details |
|---|---|---|
| Button | Button | Updated button. |
Set button target flow
Return a copy of the button that runs the given flow when clicked.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Button | Button | Yes | Button to modify. |
| Flow | Flow | Yes | Flow to invoke on click. |
Outputs
| Name | Type | Details |
|---|---|---|
| Button | Button | Updated button. |
Set button URL
Return a copy of the button as a link button pointing at the given URL. The style is forced to LINK.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Button | Button | Yes | Button to modify. |
| URL | URL | Yes | URL the button opens. |
Outputs
| Name | Type | Details |
|---|---|---|
| Button | Button | Updated link button. |
Create empty message
Create a new, blank message-content object with no text, embeds or buttons. Use the setter actions to fill it in.
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message content | The freshly created empty message content. |
Create message
Compose a message in the editor; output it for reuse or further modification.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message content | Yes | The message composed in the editor (text, embeds, components, files). |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message content | The constructed message content. |
Set message text
Return a copy of the message content with its plain text replaced.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message content | Yes | Message to modify. |
| Text | Text | Yes | Replacement plain text body. Maximum length: 2000 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message content | Updated message. |
Set message embeds
Return a copy of the message content with its embeds replaced. Discord allows at most 10.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message content | Yes | Message to modify. |
| Embeds | List of Embed | Yes | Replacement list of embeds. Maximum items: 10. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message content | Updated message. |
Add embed to message
Return a copy of the message content with the given embed appended.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message content | Yes | Message to modify. |
| Embed | Embed | Yes | Embed to append. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message content | Updated message. |
Remove embed from message at index
Return a copy of the message content with the embed at the given index removed.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message content | Yes | Message to modify. |
| Index | Whole number | Yes | Zero-based position of the embed to remove. Minimum: 0. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message content | Updated message. |
Clear message embeds
Return a copy of the message content with all embeds removed.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message content | Yes | Message to modify. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message content | Updated message without any embeds. |
Set message buttons
Return a copy of the message content with its buttons replaced. Discord allows at most 25 buttons across all rows.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message content | Yes | Message to modify. |
| Buttons | List of Button | Yes | Replacement list of buttons. Maximum items: 25. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message content | Updated message. |
Add button to message
Return a copy of the message content with the given button appended.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message content | Yes | Message to modify. |
| Button | Button | Yes | Button to append. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message content | Updated message. |
Remove button from message at index
Return a copy of the message content with the button at the given index removed.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message content | Yes | Message to modify. |
| Index | Whole number | Yes | Zero-based position of the button to remove. Minimum: 0. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message content | Updated message. |
Clear message buttons
Return a copy of the message content with all buttons removed.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message content | Yes | Message to modify. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message content | Updated message without any buttons. |
Merge message content
Return a copy of the message content with the embeds, buttons and files of another message content folded in. Useful for reusing the components an admin configured on a message config option.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message content | Yes | Message to merge into. |
| Source message | Message content | Yes | Message to take the parts from, for example a message config option. |
| Include embeds | Yes/No | Yes | Append the source's embeds. Default: Yes. |
| Include buttons | Yes/No | Yes | Append the source's buttons, dropdowns and other components. Default: Yes. |
| Include files | Yes/No | Yes | Append the source's attachments. Default: Yes. |
| Include text | Yes/No | Yes | Replace the message text with the source's text. Off by default. Default: No. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message content | Merged message. |
Disable all message components
Return a copy of the message content with every button AND every dropdown greyed out and unclickable, wherever it sits in the message - including inside containers and sections. The components stay visible, so the message still shows what was on offer; use Clear message buttons instead if you want them gone. Link and premium buttons are left working.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message content | Yes | Message whose buttons and dropdowns are disabled. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message content | Updated message with every button and dropdown disabled. |
Add dropdown to message
Return a copy of the message content with an action row appended holding the one supplied dropdown (text choices, user, role, channel or user-or-role).
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message content | Yes | Message to add the dropdown to. |
| Dropdown | Dropdown | No | Provide one of the dropdown inputs. Use only one of these: User dropdown, Role dropdown, Channel dropdown, User-or-role dropdown. |
| User dropdown | User dropdown | No | Provide one of the dropdown inputs. Use only one of these: Dropdown, Role dropdown, Channel dropdown, User-or-role dropdown. |
| Role dropdown | Role dropdown | No | Provide one of the dropdown inputs. Use only one of these: Dropdown, User dropdown, Channel dropdown, User-or-role dropdown. |
| Channel dropdown | Channel dropdown | No | Provide one of the dropdown inputs. Use only one of these: Dropdown, User dropdown, Role dropdown, User-or-role dropdown. |
| User-or-role dropdown | User-or-role dropdown | No | Provide one of the dropdown inputs. Use only one of these: Dropdown, User dropdown, Role dropdown, Channel dropdown. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message content | Updated message with the dropdown appended. |
Clear dropdowns
Return a copy of the message content with every dropdown row removed. Button rows are left untouched.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message content | Yes | Message to remove the dropdowns from. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message content | Updated message without any dropdowns. |
Set message files
Return a copy of the message content with its file attachments replaced. Discord allows at most 10.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message content | Yes | Message to modify. |
| Files | List of Attachment | Yes | Replacement list of file attachments. Maximum items: 10. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message content | Updated message. |
Add file to message
Return a copy of the message content with the given file attached.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message content | Yes | Message to modify. |
| File | Attachment | Yes | Attachment to append. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message content | Updated message. |
Remove file from message at index
Return a copy of the message content with the file at the given index removed.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message content | Yes | Message to modify. |
| Index | Whole number | Yes | Zero-based position of the file to remove. Minimum: 0. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message content | Updated message. |
Clear message files
Return a copy of the message content with all files removed. File components inside a Components V2 message are left alone.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message content | Yes | Message to modify. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message content | Updated message without any files. |
Set message text-to-speech
Return a copy of the message content with text-to-speech enabled or disabled.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message content | Yes | Message to modify. |
| Text-to-speech | Yes/No | Yes | If true, Discord reads the message aloud to recipients. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message content | Updated message. |
Set message ephemeral
Return a copy of the message content marked as only visible to the receiving user. Only valid for interaction replies.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message content | Yes | Message to modify. |
| Ephemeral | Yes/No | Yes | If true, only the receiving user sees the message. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message content | Updated message. |
Set suppress link embeds
Return a copy of the message content where Discord's automatic link previews are hidden.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message content | Yes | Message to modify. |
| Suppress | Yes/No | Yes | If true, automatic link previews are hidden. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message content | Updated message. |
Set suppress notifications
Return a copy of the message content sent silently, without push notifications.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message content | Yes | Message to modify. |
| Suppress | Yes/No | Yes | If true, recipients receive no push notification. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message content | Updated message. |
Set message allowed mentions
Return a copy of the message content with its allowed-mentions configuration replaced, controlling which mentions ping users.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message content | Yes | Message to modify. |
| Allowed mentions | Allowed mentions | Yes | Allowed-mentions configuration to apply. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message | Message content | Updated message. |
Create allowed mentions
Build an allowed-mentions configuration that controls which @-mentions actually trigger pings.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Ping @everyone / @here | Yes/No | Yes | If true, @everyone and @here mentions trigger their pings. Default: No. |
| Ping all roles | Yes/No | Yes | If true, all role mentions in the content trigger pings (unless overridden by the roles list). Default: No. |
| Ping all users | Yes/No | Yes | If true, all user mentions in the content trigger pings (unless overridden by the users list). Default: No. |
| Users | List of User | No | Specific users that may be pinged. Overrides "Ping all users". |
| Roles | List of Role | No | Specific roles that may be pinged. Overrides "Ping all roles". |
| Reply mention | Yes/No | Yes | If true, replying to a message pings its author. Default: No. |
Outputs
| Name | Type | Details |
|---|---|---|
| Allowed mentions | Allowed mentions | The constructed allowed-mentions configuration. |
Block all mentions
Return an allowed-mentions configuration that suppresses every @-mention. Equivalent to silencing all pings.
Outputs
| Name | Type | Details |
|---|---|---|
| Allowed mentions | Allowed mentions | Allowed-mentions configuration that pings nothing. |
Create attachment from URL
Build a file attachment by downloading from the given URL.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| URL | URL | Yes | URL the file is downloaded from. |
| File name | Text | Yes | File name shown in Discord. |
| Description | Text | No | Optional alt text for accessibility. |
Outputs
| Name | Type | Details |
|---|---|---|
| Attachment | Attachment | The constructed attachment. |
Create poll answer
Build a single answer option for a Discord poll.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Text | Text | Yes | Answer text shown to voters. Maximum length: 55 characters. |
| Emoji | Text | No | Optional emoji shown alongside the answer text. |
Outputs
| Name | Type | Details |
|---|---|---|
| Answer | Poll answer | The constructed poll answer. |
Add poll answer
Appends an answer to a poll answer list and returns the updated list (max 10 answers). Use the result in Create poll's answers.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Answers | List of Poll answer | No | The answer list to extend (leave empty to start a new list). Maximum items: 10. |
| Text | Text | Yes | Answer text shown to voters (1-55). Length: 1 to 55 characters. |
| Emoji | Text | No | Optional emoji shown alongside the answer text. |
Outputs
| Name | Type | Details |
|---|---|---|
| Answers | List of Poll answer | The updated answer list. |
Add container to message
Appends a Components V2 container to a message-content. Requires V2 mode to be enabled on the message.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message Content | Message content | Yes | The message-content to extend. |
| Container | Container component | Yes | The container to append. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message Content | Message content | The updated message-content. |
Add button or menu row to message
Appends a row of buttons or one dropdown to a message. This is how you put a dropdown on a normal message: unlike a container, a row does not turn the message into a Components V2 message, so it can still carry ordinary text and embeds.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message Content | Message content | Yes | The message-content to extend. |
| Row | Action row component | Yes | The row of buttons, or the row holding one dropdown, to append. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message Content | Message content | The updated message-content. |
Add text display to message
Appends a top-level text-display to a Components V2 message.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message Content | Message content | Yes | The message-content to extend. |
| Text Display | Text display component | Yes | The text-display to append. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message Content | Message content | The updated message-content. |
Add section to message
Appends a top-level section to a Components V2 message.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message Content | Message content | Yes | The message-content to extend. |
| Section | Section component | Yes | The section to append. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message Content | Message content | The updated message-content. |
Add media gallery to message
Appends a top-level media gallery to a Components V2 message.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message Content | Message content | Yes | The message-content to extend. |
| Gallery | Media gallery component | Yes | The gallery to append. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message Content | Message content | The updated message-content. |
Add separator to message
Appends a top-level separator to a Components V2 message.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message Content | Message content | Yes | The message-content to extend. |
| Separator | Separator component | Yes | The separator to append. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message Content | Message content | The updated message-content. |
Add file component to message
Appends a top-level file component to a Components V2 message.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message Content | Message content | Yes | The message-content to extend. |
| File Component | File component | Yes | The file component to append. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message Content | Message content | The updated message-content. |
Enable components V2
Sets the IS_COMPONENTS_V2 flag on the message-content so V2 components are rendered. Once enabled, classic content/embeds are no longer allowed by Discord.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message Content | Message content | Yes | The message-content to flag. |
Outputs
| Name | Type | Details |
|---|---|---|
| Message Content | Message content | The updated message-content. |
Get message content
Extracts the content/embeds/components/attachments of an existing message as message content, so you can edit it or send it elsewhere.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message | Yes | Message to convert. |
Outputs
| Name | Type | Details |
|---|---|---|
| Content | Message content | Repackaged message content. |
Clone message to channel
Re-sends a message in another channel by extracting its message content and posting through the bot. Distinct from Discord's native forward (no "Forwarded from" UI).
Required permissions: View channel, Send messages.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Source message | Message | Yes | Message whose content will be re-sent. |
| Target channel | Text channel | Yes | Channel to send the clone to. |
| Include attachments | Yes/No | Yes | Re-upload attachments. Disable to send text/embeds only. Default: Yes. |
| Include components | Yes/No | Yes | Carry over buttons / dropdowns. Their target flows are NOT carried over (clones are inert). Default: Yes. |
Outputs
| Name | Type | Details |
|---|---|---|
| Sent message | Message | The newly sent message. |
Edit message using source
Edits a message in place by copying the content from another message.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Target message | Message | Yes | Message to edit. |
| Source message | Message | Yes | Message whose content overwrites the target. |
Outputs
| Name | Type | Details |
|---|---|---|
| Updated message | Message | Target after the edit. |
Fetch message reactions
Returns the list of reactions on a message, each with its emoji and count.
Required permissions: Read message history.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Message | Message | Yes | The message to read reactions from. |
Outputs
| Name | Type | Details |
|---|---|---|
| Reactions | List of Reaction | The reactions on the message. |