Skip to content
Schedule Social Media
SchedulersNetworksAPI changesGuidesToolsCompareFind your schedulerNews

Press Esc to close.
New feature X Severity: low

X launches Account Activity API endpoints in v2

Announced20 May 2025
Effective20 May 2025
StatusIn effect

What changed

On May 20, 2025 X launched Account Activity API endpoints in X API v2. The API delivers events for subscribed user accounts (posts, deletes, mentions, replies, reposts, quotes, likes, follows, blocks, mutes, DMs, typing indicators, read receipts and app revokes) to a webhook. Its current introduction lists 3 unique subscriptions and 1 webhook on pay-per-use, says returned posts count toward the monthly Post cap, and warns that the API is being deprecated in favour of the X Activity API.

What it means

Tools that receive webhooks for posts, mentions, DMs and follows on connected X accounts can use v2 endpoints, but X now marks this API as being deprecated.

Who is affected

Developers of inbox, engagement and scheduling tools that receive X account events by webhook.

What to do by 20 May 2025

If you use the Account Activity API, register webhooks with /2/webhooks and subscribe users under /2/account_activity. For new work, use the X Activity API, which X's docs now recommend going forward.

What this means for you

Some apps tell you right away when someone replies, mentions you or sends you a message on X. To do that they listen for alerts from X. In May 2025 X moved this alert service to its newer system. X now says this service will be replaced by a newer one, so the apps you use may change how they get these alerts.

The details

  • Subscriptions: POST /2/account_activity/webhooks/:webhook_id/subscriptions/all subscribes a user, with GET routes to check, list and count subscriptions and DELETE /2/account_activity/webhooks/:webhook_id/subscriptions/:user_id/all to remove one. The /all/ product is the only option and delivers every supported event type.
  • Webhooks: register, list, delete and re-validate webhooks with /2/webhooks. URLs must be HTTPS with no port, answer the CRC check and return 200 within 10 seconds.
  • Events: tweet_create_events, tweet_delete_events, favorite_events, follow_events, unfollow_events, block_events, unblock_events, mute_events, unmute_events, direct_message_events, typing and read events, and user_event for revokes.
  • Limits: pay-per-use gets 3 unique subscriptions and 1 webhook; Enterprise gets 5000+ and 5+. The webhook limit is per account, not per app. Returned posts count toward the monthly Post cap.
  • Auth: OAuth 2.0 subscriptions were added on January 15, 2026.
  • Status: the introduction now warns that the Account Activity API "is being deprecated" and points to the X Activity API. No removal date is given.

What to do next

  • Business owners: Nothing.
  • Marketers and agencies: Nothing now. If your inbox tool shows X replies and DMs live, ask whether it is moving to the X Activity API.
  • Developers: Keep existing integrations on the v2 routes, watch the deprecation, and build new event handling on the X Activity API.

Primary sources

Checked against the source 7 Nov 2026

Get an email when a new API change is added

Follow new entries with the RSS feed. Each platform also has its own feed, for example X or Meta.