TagMangoTagMango Docs
Community

React to a message in one of your community chat rooms

PUT
/api/v1/external/community/chatrooms/{roomId}/messages/{messageId}/reactions

Set, replace, or remove your (the creator's) reaction on a message in one of your community chat rooms — a root message or a reply, in a channel-linked or direct-message room. reaction is a freeform string up to 16 characters, matching the internal app's own reaction input — there is no fixed emoji/enum list to choose from.

Send an empty string ("") to remove your existing reaction — this is not an error, it's the only way to clear a reaction. Resending the exact same value you already have set is a no-op: nothing changes, no error either.

You can only have one active reaction on a message at a time. Setting a new value replaces whatever you had set before, in the same call — there is no separate "remove old, then add new" step needed.

Always acts as you, the creator: there is no concept of an individual acting fan/UAM user for this endpoint.

The response contains the full updated message, in the same shape the send/reply/edit endpoints return, including its reactions field — an aggregate count per reaction value across everyone who has reacted, not just you — plus myReaction, your own current reaction on this message, reflecting the state just applied. myReaction is absent (not an empty string) when you have no active reaction, e.g. right after removing one.

Fails with a 400 if the Community feature is not enabled for this creator. Fails with a 404 (errorCode: CHAT_MESSAGE_SEND_ROOM_NOT_FOUND) if roomId does not exist or is not yours, or (errorCode: CHAT_MESSAGE_SEND_MESSAGE_NOT_FOUND) if messageId doesn't exist or belongs to a different room.

External access policy

An API key and an authorized white-label host are required. Both tier and plan requirements are enforced.

These requirements apply to the white-label creator for backend-to-backend access. TagMango platform access is not supported.

  • Plans: Unrestricted.

  • Tiers: Unrestricted.

AuthorizationBearer <token>

In: header

Path Parameters

roomId*string

Id of the community chat room the message belongs to

messageId*string

Id of the message to react to

Header Parameters

x-whitelabel-host*string

Host name of the dashboard, ex: mydomain.tagmango.com

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://api-prod-new.tagmango.com/api/v1/external/community/chatrooms/61e97c146cf2b4d8c68f3a40/messages/61e97c146cf2b4d8c68f3a4a/reactions" \  -H "x-whitelabel-host: string" \  -H "Content-Type: application/json" \  -d '{    "reaction": "❤️"  }'
{
  "message": {
    "_id": "6659ca9e5f2acb7abfdcd8fd",
    "room": "6659ca9e5f2acb7abfdcd8fd",
    "message": "Hello, how are you?",
    "edited": true,
    "isDeleted": true,
    "lastEditedAt": "2021-08-01T00:00:00.000Z",
    "isThreadRoot": true,
    "threadRoot": "6659ca9e5f2acb7abfdcd8fd",
    "threadRootMetadata": {
      "firstFiveRepliers": [
        "6659ca9e5f2acb7abfdcd8fd"
      ],
      "totalReplies": 5,
      "lastRepliedAt": "2021-08-01T00:00:00.000Z",
      "lastReply": "6659ca9e5f2acb7abfdcd8fd"
    },
    "reactions": {
      "😄": 5,
      "🚀": 2,
      "❤️": 10
    },
    "createdAt": "2021-08-01T00:00:00.000Z",
    "updatedAt": "2021-08-01T00:00:00.000Z",
    "poll": "6659ca9e5f2acb7abfdcd8fd",
    "pollMetadata": {
      "creator": "6659ca9e5f2acb7abfdcd8fd",
      "question": "What is your favorite color?",
      "description": "Choose your favorite color",
      "pollOptions": [
        {
          "optionContent": "string",
          "optionNumber": 0,
          "optionId": "string"
        }
      ],
      "pollEndAt": "2021-08-01T00:00:00.000Z",
      "pollVotesPerOption": {
        "id1": 5,
        "id2": 2,
        "id3": 10
      },
      "isResultVisibleToMembers": true,
      "allowVoteChange": true,
      "pollStartAt": "2021-08-01T00:00:00.000Z"
    },
    "sender": {
      "name": "John Doe",
      "profilePicUrl": "https://linktoprofilepic.com/pic.jpg",
      "_id": "6659ca9e5f2acb7abfdcd8fd",
      "isModerator": false
    },
    "assets": [
      {
        "asset": "6659ca9e5f2acb7abfdcd8fd",
        "type": "image",
        "contentUrl": "https://example.com/image.jpg",
        "fileName": "filename.jpg",
        "fileSize": 1024,
        "fileType": "jpg"
      }
    ],
    "myReaction": "string"
  }
}
{
  "code": 400,
  "type": "Bad Request",
  "statusMessage": "BAD_REQUEST",
  "success": false,
  "message": "Invalid request",
  "result": "Invalid request"
}
{
  "code": 401,
  "type": "Unauthorized",
  "statusMessage": "UNAUTHORIZED",
  "message": "Invalid token",
  "result": "Invalid token",
  "success": false
}
{
  "code": 403,
  "type": "Forbidden",
  "statusMessage": "FORBIDDEN",
  "errorCode": "WORKSHOP_MANGO_FORBIDDEN",
  "message": "You can not access this api with a TagMango account, only available for whitelabel hosts",
  "result": "You can not access this api with a TagMango account, only available for whitelabel hosts",
  "success": false
}
{
  "code": 429,
  "type": "Too Many Requests",
  "statusMessage": "TOO_MANY_REQUESTS",
  "message": "Request limit exceeded. try after 10 seconds",
  "result": "Request limit exceeded. try after 10 seconds",
  "success": false
}