Messages

Add or remove a reaction to a message

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.

post/v3/messages/{messageId}/reactions

Request

  • Base URL: https://api.linqapp.com/api/partner
  • URL: https://api.linqapp.com/api/partner/v3/messages/{messageId}/reactions
  • Auth: HTTP bearer

Path parameters

messageIdstring uuid required
Example:69a37c7d-af4f-4b5e-af42-e28e98ce873a

Unique identifier of the message to react to

Request body

operation'add' | 'remove' required

Whether to add or remove the reaction

type'love' | 'like' | 'dislike' | 'laugh' | 'emphasize' | 'question' | 'custom' | 'sticker' required

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.

custom_emojistring

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.

emojistring

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.

urlstring uri

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".

attachment_idstring uuid

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".

part_indexinteger

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

Example request

{
  "operation": "add",
  "type": "love"
}

Response

Reaction queued successfully

statusstring
trace_idstring
messagestring

Example response

{
  "status": "accepted",
  "message": "Reaction processed"
}

Changes

No recorded changes to this operation across all 1 revision of this API.