Log inStart Free Trial
easyCoexistence Official APIs

Instagram message_reactions webhook: the react and unreact payload

Instagram's message_reactions webhook field notifies an app when a person reacts to a message in their conversation with a professional account, or removes the reaction. The event sits in the messaging array with a reaction object: mid, the ID of the message reacted to; action, react or unreact; and, on a react only, reaction, such as love, and emoji, the emoji itself.

easyCoexistence subscribes each connected Instagram account to comments, messages and mentions and forwards those events to your HTTPS endpoint as they arrive, signed with that account's secret, each message with its mid.

react / unreact

The two values of reaction.action: a reaction added, or a reaction removed.

v12.0

Graph API version from which Meta supports angry, sad, wow, love, like, laugh and other reactions in this webhook.

No echo

Meta sends no notification when the account itself reacts to or unreacts a person's message.

Default

message_reactions is among the fields a new Instagram product in the App Dashboard starts subscribed to.

100/sec

Send API calls per second per account for text, links, reactions and stickers.

When does message_reactions fire?

When a person reacts to a message in their conversation with the professional account, and again when they remove that reaction, once the app and the account are subscribed to the field. Meta's Instagram Messaging guide is explicit about the other direction: when the account itself reacts or unreacts, no notification is sent, and messages delivers no echo for it either.

What does a reaction notification look like?

A POST with object set to instagram, whose entry holds a messaging array. Unlike a DM, the event carries no message object: the reaction sits in its own reaction object, beside sender, recipient and timestamp. Meta's example for Instagram Login:

A message_reactions notification, as Meta sends it
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448000512,
      "messaging": [
        {
          "sender": { "id": "<IGSID>" },
          "recipient": { "id": "<IG_ID>" },
          "timestamp": 1793447999874,
          "reaction": {
            "mid": "<MESSAGE_ID>",
            "action": "react",
            "reaction": "love",
            "emoji": "\u{2764}\u{FE0F}"
          }
        }
      ]
    }
  ]
}

What does each field mean?

The fields Meta documents for a reaction event, from the outside in:

  • entry[].id and recipient.id: the professional account. sender.id: the Instagram-scoped ID of the person who reacted.
  • timestamp: when the event was triggered, in milliseconds in Meta's samples; entry[].time is when Meta sent the notification.
  • reaction.mid: the ID of the message reacted to, the same mid that message had in its messages event.
  • reaction.action: react when a reaction is added, unreact when it is removed.
  • reaction.reaction: the reaction's name, such as love; Meta lists angry, sad, wow, love, like, laugh and other.
  • reaction.emoji: the emoji as a Unicode string, such as \u{2764}\u{FE0F} for love.
  • On unreact, reaction and emoji are left out.

What does an unreact look like?

The same event with action set to unreact and neither reaction nor emoji, since nothing is left to name. Match it to the reaction it removes by reaction.mid and sender.id, and drop that person's reaction from the message in your records.

The reaction object of an unreact
"reaction": {
  "mid": "<MESSAGE_ID>",
  "action": "unreact"
}

Which message does mid point to?

The message the person reacted to, under the same mid it carried in its messages event, echoes of the account's own messages included. A handler that stores mids can attach the reaction to the right line of the conversation. Meta notes one gap: a reaction to one image of a carousel post reports the carousel's first image, which may not be the one chosen.

How does an account react to a message?

With POST /<IG_ID>/messages: recipient.id set to the person's Instagram-scoped ID, sender_action set to react, and a payload holding message_id and reaction, an emoji or its UTF-8 form. Repeating the call with another emoji changes the reaction, and sender_action set to unreact with only message_id removes it. Neither call produces a webhook.

Reacting to a person's message
POST https://graph.instagram.com/<IG_ID>/messages
Authorization: Bearer <INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json

{
  "recipient": { "id": "<IGSID>" },
  "sender_action": "react",
  "payload": {
    "message_id": "<MESSAGE_ID>",
    "reaction": "<EMOJI>"
  }
}

What does message_reactions need?

With Instagram Login, instagram_business_basic and instagram_business_manage_messages, and Advanced Access for accounts the developer does not own or manage. A new Instagram product in the App Dashboard starts subscribed to message_reactions, and each account is subscribed through POST /<IG_ID>/subscribed_apps. Meta's Send Messages guide lists it as messaging_reactions, but its fields table, dashboard defaults and webhook reference say message_reactions.

Does easyCoexistence forward reactions?

No. easyCoexistence's app and each connected account are subscribed to comments, messages and mentions only, so message_reactions events are not forwarded to your endpoint. The DMs and echoes that reactions point to by their mid do reach it, signed with the account's secret.

Common mistakes

  • Looking for the reaction inside message. A reaction event has no message object; read the reaction object beside sender and recipient.
  • Reading reaction or emoji without checking action. Both are left out on unreact, so code that assumes them breaks when a reaction is removed.
  • Waiting for a webhook after the account reacts. Meta sends none for the account's own reactions, not even an echo, so record them when your app sends them.
  • Copying the name messaging_reactions from Meta's Send Messages guide. The field in its fields table, dashboard defaults and webhook reference is message_reactions.
Doing this with EasyCoexistence

Your agent replies to a person with send_social_dm inside the 24-hour window. US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.

easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.

Frequently asked questions

Why does a reaction on a carousel post point to the first image?

Meta reports the carousel's first image when someone reacts to one of its images, which may not be the image the person chose.

Does Instagram send a webhook when the business reacts to a message?

No. Meta sends no message_reactions notification and no echo when the account reacts to or unreacts a message.

Which reactions can the Instagram webhook report?

Meta's Instagram Messaging guide lists angry, sad, wow, love, like, laugh and other from Graph API v12.0, with the emoji itself in reaction.emoji.

Is the webhook field message_reactions or messaging_reactions?

message_reactions. Meta's Send Messages guide writes messaging_reactions, but its fields table, App Dashboard defaults and webhook reference all use message_reactions.

Keep reading

Connect your first channel in two minutes.

No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.

  • 3 days free
  • Cancel any time
  • Official APIs only
  • Monitored 24/7

Verified on