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

# Send or withdraw reactions

`POST /{scope_id}/react`

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.net/kommo/apis/kommo-api-references.md) · [All operations](https://skmtc.net/kommo/apis/kommo-api-references/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kommo/kommo-api-references/revisions/f17af4d23c7c/schema)