Social

Notification Object JSON Example

A JSON example for an in-app or push notification — includes notification type, actor, action subject, deep-link, read status, and grouping metadata.

JSON

Generate mock data Open in Formatter

{
  "id": "notif_5pRtVqKz9m",
  "recipientId": "usr_9k2mXpQr4t",
  "type": "post.liked",
  "actor": {
    "id": "usr_Wx3yNmLp7q",
    "username": "priya.sharma",
    "displayName": "Priya Sharma",
    "avatarUrl": "https://cdn.example.com/avatars/usr_Wx3yNmLp7q.jpg"
  },
  "subject": {
    "type": "post",
    "id": "post_8vKqNmTr5j",
    "preview": "Just deployed our new JSON API..."
  },
  "message": "Priya Sharma liked your post",
  "deepLink": "/posts/post_8vKqNmTr5j",
  "isRead": false,
  "isGrouped": false,
  "groupCount": 1,
  "priority": "normal",
  "channel": "in-app",
  "createdAt": "2025-06-01T11:04:22Z",
  "expiresAt": null
}

Field Reference

idrequiredstringUnique notification identifier

recipientIdrequiredstringUser ID who should receive this notification

typerequiredstringNotification type in dot notation: entity.action (post.liked, comment.replied, follow.new)

actoroptionalobjectUser who triggered the notification — absent for system notifications

subjectoptionalobjectThe content item the notification is about — post, comment, product, etc.

deepLinkoptionalstringIn-app path or URL to navigate to when the notification is tapped

isReadrequiredbooleanWhether the user has read/dismissed this notification

priorityoptionalstringDelivery priority: normal, high, or urgent (affects push delivery speed)

channelrequiredstringDelivery channel: in-app, push, email, or sms

Variants

GroupedMultiple likes grouped into a single notification.

Grouped

Generate mock data Open in Formatter

{
  "id": "notif_grp_001",
  "recipientId": "usr_9k2mXpQr4t",
  "type": "post.liked",
  "actor": null,
  "message": "Priya, Amit, and 12 others liked your post",
  "deepLink": "/posts/post_8vKqNmTr5j",
  "isRead": false,
  "isGrouped": true,
  "groupCount": 14,
  "actors": [
    {
      "id": "usr_Wx3yNmLp7q",
      "username": "priya.sharma",
      "avatarUrl": "..."
    },
    {
      "id": "usr_KmT4nPqR8v",
      "username": "amit.patel",
      "avatarUrl": "..."
    }
  ],
  "priority": "normal",
  "channel": "in-app",
  "createdAt": "2025-06-01T13:00:00Z"
}

Common Use Cases

→Rendering a notification feed sorted by createdAt with unread count badge
→Sending push notifications via Firebase Cloud Messaging (FCM) or APNs
→Marking notifications as read via PATCH /notifications/:id

notificationpushin-appreal-timealert

Validate or format this JSON

One click loads this exact example into the tool — no copy-paste needed. Format it, validate it, explore the tree, or generate TypeScript types instantly.

Format Validate Explore tree Generate TypeScript Minify

Frequently Asked Questions

Group by type + subject.id within a time window (e.g. 1 hour). When a new matching notification arrives, update the group's actor list and groupCount rather than creating a new record. Show 'Priya and 3 others liked your post' instead of 4 separate notifications.

Store a snapshot of the actor's display name and avatar URL at the time the notification was created. This avoids a join on every notification render and ensures the notification still makes sense if the actor later changes their name or deletes their account.

Related JSON Examples

SocialSocial Media PostSocial post with author info, text content, media, engagement counters, and hashtags.ContentPush NotificationPush notification with title, body, deep-link data, and platform-specific options.API DesignUser ProfileStandard user profile JSON with personal info, address, and account metadata.