App Logo
discord.com

add_reaction

React to a Discord message with a unicode emoji, or remove your own reaction with remove:true. Takes the message's own url, as copied from Discord or returned by discord.com/read_messages. Returns the emoji, the message and channel ids, whether your reaction was already there before this ran, and the reaction's count afterwards. Reactions are visible to everyone who can see the channel. Supports a small set of common emoji rather than any glyph, since Discord's picker only accepts an emoji name to search, not a pasted character. Does not work on a forum post's own opening message, whose context menu is shaped differently from a regular message's — react to a reply in the post instead.

Input

emoji required

A single unicode emoji, e.g. a thumbs up. Limited to a set of common emoji this script can name for Discord's picker search (thumbs up/down, heart, laughing, fire, 100, eyes, check mark, clap, party popper, thinking, and a few more); an emoji outside that set is refused with a clear reason rather than guessed at. Custom server emoji are not supported.

messageUrl required

Full message url, e.g. https://discord.com/channels/<guildId>/<channelId>/<messageId>. discord.com/read_messages returns the ids to build one.

remove optional

Leave false (the default) to add your reaction. Set true to take your own reaction off; other people's reactions are never touched.

Default: false

Output

emoji required
reacted required

Whether your reaction is on the message after this run.

channelId required
messageId required
already_present required

True when the message was already in the requested state, so nothing was written.

count optional

How many people have reacted with this emoji afterwards, as Discord shows it; null once no pill remains.

request_seen optional

Whether Discord's own reaction request was observed for this change.

Start building not clicking