---
title: "reaction.received"
method: POST
path: "reaction.received"
---

# reaction.received

`POST reaction.received` (webhook)

A reaction was added or removed on a message (Facebook & Instagram).

## Payload

- WebhookEventReaction: Envelope shared by every webhook delivery.
  - `id` string, required: Delivery ID, prefixed with whevt_. Matches the X-Postproxy-Delivery header.
  - `object` 'event', required: Always "event".
  - `type` string, required: Event type (e.g. platform_post.published). Matches the X-Postproxy-Event header.
  - `created_at` string, required: ISO 8601 timestamp of when the event was generated.
  - `data` object, required: Container for the event-specific resource.
    - `object` object: Reaction payload. Facebook & Instagram only.
      - `message` object: The full message object, reflecting the post-reaction state (the reactions array already has the reactor added for react, or removed for unreact).
      - `sender_external_id` string: Platform ID of whoever placed/removed the reaction (participant PSID/IGSID, or your own profile.external_id for business reactions).
      - `action` 'react' | 'unreact'
      - `reaction` string, nullable: Named reaction (e.g. love).
      - `emoji` string, nullable: Unicode emoji; may be absent on Messenger and on unreact events.
      - `occurred_at` string, nullable: ISO 8601 time the reaction occurred.

## Acknowledgement `200`

Acknowledged

---

[API](https://skmtc.dev/postproxy/apis/postproxy-social-media-api.md) - [All operations](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/llms.txt) - [OpenAPI document](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/revisions/d54482ac4ce7?raw)