Sign in
latestOpenAPI 3.1.02026-08-193894215.9 MB

23dfbe1a0d1f

Reactions

Create reaction

Add an emoji reaction or poll vote to a message or forum post. In forums, the reaction is always a like.

Required permissions (one of):

  • chat:read
  • dms:read
  • forum:read
  • livestream:chat:read
  • support_chat:read
post/reactions

Request body

emojistring nullable

The emoji to react with, in shortcode or unicode format. For example, ':heart:' or a unicode emoji. Ignored in forums where reactions are always likes.

poll_option_idstring nullable

The unique identifier of a poll option to vote for. Only valid when the target message or post contains a poll.

resource_idstring required

The unique identifier of the message or forum post to react to.

Response

A successful response

emojistring nullable required

The emoji used for this reaction in shortcode format. Null if the reaction type is not emoji.

idstring required

The unique identifier for the entity

resource_idstring required

The unique identifier of the post this reaction was left on.

Example response

{
  "emoji": ":heart:",
  "id": "reac_xxxxxxxxxxxxxxxxxxxxxx",
  "user": {
    "id": "user_xxxxxxxxxxxxx",
    "name": "John Doe",
    "username": "johndoe42"
  }
}