From 130a1c80295c99337c9b3e02acaa19309f54d6e5 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Tue, 15 Sep 2026 17:28:19 +0000
Subject: [PATCH] docs: add post_id qualifier for like.create in XAA filter
 qualifiers

---
 x-api/activity/introduction.mdx | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/x-api/activity/introduction.mdx b/x-api/activity/introduction.mdx
index 26e3434bf..910d1ce5b 100644
--- a/x-api/activity/introduction.mdx
+++ b/x-api/activity/introduction.mdx
@@ -207,9 +207,24 @@ The following qualifiers are currently supported:
 | --- | --- | --- |
 | `conversation_type` | `direct`, `group` | `chat.received` |
 | `direction` | `inbound`, `outbound` | `follow.follow`, `follow.unfollow`, `like.create`, `subscriptions.subscribe`, `subscriptions.unsubscribe` |
+| `post_id` | A Post ID | `like.create` |
 
 The `direction` qualifier is equivalent to the top-level `filter.direction` field. Both remain supported.
 
+Use `post_id` to receive `like.create` events only for likes on a specific Post. For example, to receive `like.create` events for likes on Post `1234567890123456789`:
+
+```json
+{
+  "event_type": "like.create",
+  "filter": {
+    "user_id": "1830023695835787264",
+    "qualifiers": { "post_id": "1234567890123456789" }
+  },
+  "webhook_id": "2090847910112202752",
+  "tag": "likes on a specific post"
+}
+```
+
 For example, to receive `chat.received` events for one-on-one conversations only:
 
 ```json