## Add or remove a reaction to a message

**post** `/v3/messages/{messageId}/reactions`

Add or remove emoji reactions to messages. Reactions let users express
their response to a message without sending a new message.

**Supported Reactions:**

- love ❤️
- like 👍
- dislike 👎
- laugh 😂
- emphasize ‼️
- question ❓
- custom - any emoji as a tapback (use `custom_emoji` field to specify)
- sticker - an emoji or image peeled onto the message (use `emoji`, `url` or `attachment_id`)

**`custom` and `sticker` are different products.** A `custom` reaction is a
tapback: the emoji sits in a small bubble on the corner of the message. A
`sticker` is peeled onto the bubble itself, and can be dragged, resized and
rotated. Both accept an emoji; they do not look alike.

**Stickers** are iMessage-only and cannot be removed, so
`operation: "remove"` with `type: "sticker"` is rejected. Position, size
and rotation are optional via `placement`, and can be changed afterwards
with `PATCH /v3/messages/{messageId}/reactions/{reactionId}`. An animated
image peels as an animated sticker, in whatever shape the file already has.

**Polls** take stickers only. Any tapback on a poll message — standard or
`custom` — is rejected with a 400.

### Path Parameters

- `messageId: string`

### Body Parameters

- `operation: "add" or "remove"`

  Whether to add or remove the reaction

  - `"add"`

  - `"remove"`

- `type: ReactionType`

  Type of reaction. Standard iMessage tapbacks are love, like, dislike, laugh, emphasize, question.
  Custom emoji reactions have type "custom" with the actual emoji in the custom_emoji field.
  Sticker reactions have type "sticker" with sticker attachment details in the sticker field.

  - `"love"`

  - `"like"`

  - `"dislike"`

  - `"laugh"`

  - `"emphasize"`

  - `"question"`

  - `"custom"`

  - `"sticker"`

- `attachment_id: optional string`

  Reference to a sticker image pre-uploaded via `POST /v3/attachments`.
  Only valid when type is "sticker".

  Exactly one of `emoji`, `url` or `attachment_id` is required when
  type is "sticker".

- `custom_emoji: optional string`

  Custom emoji string. Required when type is "custom".

  This is a **tapback** — the emoji sits in the tapback bubble on the
  corner of the message. To peel an emoji onto the message as a
  draggable sticker instead, use type "sticker" with `emoji`.

- `emoji: optional string`

  A single emoji to peel onto the message as a sticker. Only valid
  when type is "sticker".

  Exactly one of `emoji`, `url` or `attachment_id` is required when
  type is "sticker".

  Not to be confused with `custom_emoji`, which produces a tapback.

- `part_index: optional number`

  Optional index of the message part to react to.
  If not provided, reacts to the entire message (part 0).

- `placement: optional object { rotation, scale, x, y }`

  Optional position, size and rotation of a sticker on the target
  bubble. Only valid when type is "sticker".

  Every field is independent and optional — omit the object entirely,
  or any field within it, to keep the default (centred, default size,
  unrotated).

  - `rotation: optional number`

    Clockwise rotation in degrees.

  - `scale: optional number`

    How large the sticker is drawn. Omit it for the default size —
    equivalent to `1` for an image, or `0.5` for an emoji.

    Values outside 0.05–2.5 are clamped rather than rejected.

    Scale is linear, so 2.5 is a little over six times the area.

  - `x: optional number`

    Horizontal position on the target bubble, from -1 (far left) to
    1 (far right). 0 is centred.

  - `y: optional number`

    Vertical position on the target bubble, from -1 (top) to
    1 (bottom). 0 is centred.

- `url: optional string`

  Linq attachment URL of the sticker image — the `download_url`
  returned by `POST /v3/attachments`. Only valid when type is
  "sticker".

  The image must already be stored with us. To send a sticker from
  elsewhere, upload it with `POST /v3/attachments` first and pass
  `attachment_id`.

  Exactly one of `emoji`, `url` or `attachment_id` is required when
  type is "sticker".

### Returns

- `message: optional string`

- `status: optional string`

- `trace_id: optional string`

### Example

```http
curl https://api.linqapp.com/api/partner/v3/messages/$MESSAGE_ID/reactions \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $LINQ_API_V3_API_KEY" \
    -d '{
          "operation": "add",
          "type": "love",
          "attachment_id": "550e8400-e29b-41d4-a716-446655440000",
          "emoji": "🎉",
          "part_index": 1,
          "url": "https://cdn.linqapp.com/attachments/example/sticker.png"
        }'
```

#### Response

```json
{
  "message": "Reaction processed",
  "status": "accepted",
  "trace_id": "trace_id"
}
```