---
title: "Send or withdraw reactions"
method: POST
path: "/{scope_id}/react"
---

# Send or withdraw reactions

`POST /{scope_id}/react`

## Request

- Base URL: `https://amojo.kommo.com/v2/origin/custom`
- URL: `https://amojo.kommo.com/v2/origin/custom/{scope_id}/react`
- Auth: none required

The method allows you to send or remove a reaction from a specific message.

## Path parameters

- `scope_id` string, required

## Headers

- `Content-Type` string
- `Date` string
- `Content-MD5` string
- `X-Signature` string

## Request body

- object
  - `conversation_id` string: Chat ID on the integration side
  - `conversation_ref_id` string: The chat ID on the Chats API side. Optional if `conversation_id` is passed.
  - `id` string: Message ID on the Kommo side. The field is required if the msgid field is not passed
  - `msgid` string: Message ID on the integration side. The field is required if the id field is not passed
  - `user` object
    - `id` string: ID of the user who has sent/removed the reaction on the integration side
    - `ref_id` string: ID of the user who has sent/removed the reaction on the Kommo side. Required field when entering a reaction by the user of Kommo
  - `type` 'react' | 'unreact': Action type
  - `emoji` string: Required field for the “react” type

## Response `200`

200

- object

## Other responses

- `400`: 400
- `403`: 403
- `404`: 404

---

[API](https://skmtc.dev/kommo/apis/chats-api.md) - [All operations](https://skmtc.dev/kommo/apis/chats-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kommo/apis/chats-api/revisions/174554fdf536?raw)