> ## Documentation Index
> Fetch the complete documentation index at: https://docs.periskope.app/llms.txt
> Use this file to discover all available pages before exploring further.

# The Chat Notification Object

> A chat notification — a group system event such as participants being added or removed, admin changes or setting changes. Stored in tbl_chat_notifications.

<ResponseExample>
  ```json The Chat Notification Object theme={null}
  {
    "notification_id": "true_120363000000000000@g.us_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa_911111111111@c.us_add",
    "org_id": "00000000-0000-0000-0000-000000000000",
    "org_phone": "911111111111@c.us",
    "chat_id": "120363000000000000@g.us",
    "author": "911111111111@c.us",
    "body": null,
    "type": "add",
    "recipientids": [
      "922222222222@c.us"
    ],
    "id": {
      "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "fromMe": true,
      "remote": "120363000000000000@g.us",
      "serialized": "true_120363000000000000@g.us_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa_911111111111@c.us_add"
    },
    "timestamp": "2026-01-15T09:30:00+00:00",
    "unique_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "metadata": null,
    "call_metadata": null
  }
  ```
</ResponseExample>

**Attributes**

<ParamField path="notification_id" type="string">
  Unique id of the notification, in the form \<from\_me>*\<chat\_id>*\<wa\_id>*\<author>*\<type>
</ParamField>

<ParamField path="org_id" type="string">
  Id of the organization the notification belongs to
</ParamField>

<ParamField path="org_phone" type="string">
  Org phone (WhatsApp account) the notification was observed on, as country code + number suffixed with @c.us
</ParamField>

<ParamField path="chat_id" type="string">
  Chat the notification belongs to
</ParamField>

<ParamField path="author" type="string">
  Participant who performed the action (\<countrycode>\<number>@c.us)
</ParamField>

<ParamField path="body" type="string">
  Text of the notification, when WhatsApp provides one
</ParamField>

<ParamField path="type" type="string">
  Kind of group event, e.g. 'add', 'remove', 'promote', 'demote', 'leave', 'invite', 'create', 'subject', 'picture', 'memberaddmode\_true', 'memberaddmode\_false'
</ParamField>

<ParamField path="recipientids" type="string[]">
  Participants affected by the event (e.g. the contacts that were added or removed).
</ParamField>

<ParamField path="id" type="object">
  Raw WhatsApp id object of the notification (id, remote, fromMe, serialized)

  <Expandable title="properties" />
</ParamField>

<ParamField path="timestamp" type="string">
  When the event happened, as an ISO 8601 UTC timestamp
</ParamField>

<ParamField path="unique_id" type="string">
  WhatsApp id of the notification without the id prefix
</ParamField>

<ParamField path="metadata" type="object">
  Extra event metadata, when present
</ParamField>

<ParamField path="call_metadata" type="object">
  Call details for call notifications, when present
</ParamField>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.