React to a message in one of your community chat rooms
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.
Authorization
bearer In: header
Path Parameters
Id of the community chat room the message belongs to
Id of the message to react to
Header Parameters
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
}