diff --git a/changelog.mdx b/changelog.mdx
index c1db3554d..e7002bd3b 100644
--- a/changelog.mdx
+++ b/changelog.mdx
@@ -7,6 +7,32 @@ keywords: ["changelog", "API updates", "release notes", "what's new", "API chang
 
 To subscribe to updates, please [**“Turn on notifications”**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive) for [**@API**](https://x.com/api). You can also follow this changelog in your feed reader via the [**RSS feed**](https://docs.x.com/changelog/rss.xml).
 
+<Update label="Aug 28, 2026" description="X API v2">
+  ### New features
+
+  #### Filter qualifiers for X Activity API subscriptions
+
+  [X Activity API](/x-api/activity/introduction) subscriptions now accept an optional `filter.qualifiers` map of event-specific predicates, so you receive only the events you care about. Use `conversation_type` (`direct` or `group`) on `chat.received`, and `direction` (`inbound` or `outbound`) on `follow.follow`, `follow.unfollow`, and `like.create`. Each subscription supports up to 8 qualifiers. See [Filter qualifiers](/x-api/activity/introduction#filter-qualifiers) for details.
+
+  #### Broadcast lifecycle events for X Activity API
+
+  We added `broadcast.start` and `broadcast.end` events to the [X Activity API](/x-api/activity/introduction). Subscribe by User ID to be notified in real time when a user starts or ends a live broadcast. Both are public events, so you can subscribe with either app-only or user-context authentication. Sample payloads are available in the [event payloads reference](/x-api/activity/event-payloads).
+
+  #### New `GET /2/usage/credits` endpoint
+
+  You can now check your Pay-Per-Use credit balance programmatically. The new [`GET /2/usage/credits`](/x-api/usage/get-usage-credits) endpoint returns your PPU credit balance in USD, making it easier to monitor spend and avoid interruptions.
+
+  ### Updates
+
+  #### `is_subscriber` field on `broadcast.chat` events
+
+  The `broadcast.chat` event payload now includes an `is_subscriber` boolean, so you can tell whether a chat message came from a subscriber. See the [event payloads reference](/x-api/activity/event-payloads).
+
+  #### Pay-Per-Use monthly Post cap raised to 3 million
+
+  The monthly [Post read cap](/x-api/fundamentals/post-cap) on Pay-Per-Use plans increased from 2 million to 3 million Posts. If you need higher volume, consider an Enterprise plan.
+</Update>
+
 <Update label="Aug 13, 2026" description="X Ads API">
   ### Updated `video_total_views` definition