diff --git a/changelog.mdx b/changelog.mdx index b965396ee..48e2c721e 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -7,6 +7,23 @@ 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). + + ### Filter qualifiers for X Activity API subscriptions + + We added an optional `filter.qualifiers` map to [X Activity API](/x-api/activity/introduction) subscriptions. Qualifiers let you narrow which events match, so your webhook only receives the events you care about. Each subscription accepts up to 8 key-value entries, and unsupported keys or values return a **400** error. + + Supported qualifiers: + + - `conversation_type` (`direct` or `group`) on `chat.received` + - `direction` (`inbound` or `outbound`) on `follow.follow`, `follow.unfollow`, and `like.create` + + The create, list, and update subscription responses echo `filter.qualifiers` back. See [Filter qualifiers](/x-api/activity/introduction#filter-qualifiers) for details and examples. + + ### `is_subscriber` field in `broadcast.chat` events + + The `broadcast.chat` event payload now includes an `is_subscriber` boolean indicating whether the chat message author is a subscriber. See the [event payloads reference](/x-api/activity/event-payloads) for a sample payload. + + ### Media upload and Post-create size and duration limits