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
16 changes: 16 additions & 0 deletions changelog.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,22 @@ 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 25, 2026" description="X API v2 & X Ads API">
### This week: Ads MCP, broadcast events, and new endpoints

**New features**

- **X Ads MCP server**: We launched the [Ads MCP](/x-ads-api/mcp), a remote MCP (Model Context Protocol) server at `https://ads-api.x.com/mcp`. Any MCP-capable client, such as Grok or Claude Code, can now read campaign data, run analytics, and manage campaigns through natural language using 23 X Ads tools. Access is scoped to your own OAuth 2.0 token, and campaigns and line items are always created `PAUSED` so nothing spends money until you activate it. See the [tool reference](/x-ads-api/mcp/reference).
- **Broadcast events in 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 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.
- **Credit balance endpoint**: The new [`GET /2/usage/credits`](/x-api/usage/get-usage-credits) endpoint returns your developer-platform credit balance in USD, so Pay-Per-Use developers can monitor remaining credits programmatically.
- **Delete Chat messages**: The new [`POST /2/chat/conversations/{id}/messages/delete`](/x-api/chat/delete-chat-messages) endpoint deletes one or more messages from a Chat conversation. You can delete a message for all participants or only from your own view.

**Updates**

- **New web conversion metrics in Ads Analytics**: We added eight metrics to the `WEB_CONVERSION` metric group of the [X Ads API Analytics endpoints](/x-ads-api/analytics), including `conversion_add_to_carts`, `conversion_checkouts_initiated`, and `conversion_landing_page_views`. We also added a `CONVERSION_TAGS` segmentation type, compatible with the `WEB_CONVERSION` metric group only.
- **Higher pay-per-usage Post cap**: The monthly cap for pay-per-usage plans increased from 2 million to 3 million Post reads. See [Usage and Billing](/x-api/fundamentals/post-cap).
</Update>

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

Expand Down