Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions changelog.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,24 @@ 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="Weekly roundup">
### This week: Bots for the Chat API, X Ads MCP, and more

#### New features

- **Bot accounts for the Chat API**: We added `/2/bots` [endpoints](/x-api/bots/get-bots) for creating and managing programmatic bot accounts owned by your project. You can create a bot, mint and rotate its bearer token, revoke the token, update its handle, display name, and DM permissions, and delete the bot. Bot accounts carry an "Automated by" label. See the [Bots guide](/xchat/bots) to get started.
- **X Ads MCP**: We launched the [X Ads MCP](/x-ads-api/mcp), a remote MCP server at `https://ads-api.x.com/mcp`. Any MCP-capable client (Grok, Claude Code, or your own agent) can read campaign data, run analytics, and create and manage campaigns through natural language. Access is scoped to your OAuth 2.0 token, and new campaigns and line items are always created paused.
- **Broadcast events for the 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 receive real-time notifications when a user starts or ends a live broadcast. Both are public events and work with app-only or user-context authentication.
- **Subscription filter qualifiers for the X Activity API**: Subscriptions now accept an optional `filter.qualifiers` map (up to 8 entries) to narrow which events match. Supported qualifiers include `conversation_type` (`direct`, `group`) for `chat.received` and `direction` (`inbound`, `outbound`) for `follow.follow`, `follow.unfollow`, and `like.create`. Learn more in the [X Activity API introduction](/x-api/activity/introduction#filter-qualifiers).
- **Usage credits endpoint**: We added [`GET /2/usage/credits`](/x-api/usage/get-usage-credits), which returns your developer-platform credit balance in USD, including prepaid, free, and total balances.
- **Delete Chat messages**: We added [`POST /2/chat/conversations/{id}/messages/delete`](/x-api/chat/delete-chat-messages) to the Chat API. Delete one or more messages from a conversation, either for every participant or only from your own view.

#### Updates

- **Pay-per-use monthly Post cap raised to 3 million**: The monthly cap on Post reads for pay-per-use plans increased from 2 million to 3 million. See [Post cap](/x-api/fundamentals/post-cap) for details.
- **`is_subscriber` in `broadcast.chat` payloads**: The `broadcast.chat` event payload in the [X Activity API](/x-api/activity/event-payloads) now includes an `is_subscriber` boolean indicating whether the chat message author is a subscriber of the broadcaster.
</Update>

<Update label="Aug 13, 2026" description="X Ads API">
### Updated `video_total_views` definition

Expand Down