Migrate from the Account Activity API to the X Activity API

​

Summary

• Managed migration. Submit a request and the X team migrates your existing AAA subscriptions to XAA for you. See Managed migration.
• Self-serve migration. Create the XAA subscriptions yourself using the API. See Self-serve migration.

​

Benefits of XAA

• Covers everything AAA delivers. Posts, mentions, replies, quotes, reposts, deletes, likes, follows, blocks, mutes, DMs, typing indicators, read receipts, and app revocations all have XAA equivalents. See the event mapping.
• Granular subscriptions. Instead of an all-or-nothing subscription per user, choose exactly which event types you want for each user, and narrow them further with filter qualifiers such as direction, post_id, and conversation_type. You only receive, and process, the events you need.
• New event types. XAA supports event families AAA never served, including encrypted XChat messages, profile updates, live broadcast start, end, and chat events, Spaces, paid subscriptions, and Grok-curated news headlines filtered by keyword. See Supported event types.
• Webhook or streaming delivery. Receive events on your existing webhook, over a persistent HTTP stream, or both. The stream supports up to 5 minutes of backfill on connect and recovery of missed events with start_time and end_time.
• Keep your webhook and your users’ authorizations. XAA uses the same V2 Webhooks API, CRC checks, and signature headers as AAA, so you can point XAA subscriptions at the webhook you already use. XAA accepts the OAuth 1.0a user access tokens you already hold, so users don’t need to re-authorize your app to migrate.
• OAuth 2.0 with fine-grained scopes. XAA supports OAuth 2.0, so you can request only the scopes you need (for example dm.read, like.read, block.read, mute.read, tweet.read). OAuth 1.0a support in XAA will be deprecated soon, so plan to move your users to OAuth 2.0.
• Same replay window. Recover events from the past 24 hours with POST /2/webhooks/replay, the same window as AAA replay.
• X API v2 data format. Post and user objects match the rest of X API v2, with related objects in includes, so the same parsing code works across endpoints.
• Better subscription management. Tag subscriptions, set an automatic expires_at, list subscriptions for a single user, and delete up to 100 subscriptions in one request.

​

Managed migration

​

AAA to XAA event mapping

​

What changes for your integration

​

Payload format

{
  "for_user_id": "2244994945",
  "favorite_events": [
    {
      "id": "a7ba59eab0bfcba386f7acedac279542",
      "created_at": "Mon Mar 26 16:33:26 +0000 2018",
      "favorited_status": { "...": "v1.1 Tweet object" },
      "user": { "...": "v1.1 User object" }
    }
  ]
}

{
  "data": {
    "event_uuid": "2080761390344937796",
    "created_at": "2026-10-07T19:17:36.304Z",
    "filter": { "user_id": "2244994945" },
    "event_type": "like.create",
    "tag": "aaa-migration",
    "payload": { "...": "event-specific data" },
    "includes": { "...": "related v2 users and Posts" }
  }
}

​

Behavior differences

​

Self-serve migration

import requests
from requests_oauthlib import OAuth1

EVENT_TYPES = [
    "post.create", "post.delete", "post.mention.create", "post.reply.create",
    "post.quote.create", "post.repost.create", "like.create",
    "follow.follow", "follow.unfollow", "block.block", "block.unblock",
    "mute.mute", "mute.unmute", "dm.sent", "dm.received", "dm.read",
    "dm.indicate_typing",
]

auth = OAuth1(CONSUMER_KEY, CONSUMER_SECRET, USER_ACCESS_TOKEN, USER_ACCESS_TOKEN_SECRET)

for event_type in EVENT_TYPES:
    response = requests.post(
        "https://api.x.com/2/activity/subscriptions",
        auth=auth,
        json={
            "event_type": event_type,
            "filter": {"user_id": USER_ID},
            "webhook_id": WEBHOOK_ID,
            "tag": "aaa-migration",
        },
    )
    print(event_type, response.status_code, response.json())

​

Frequently asked questions

​

Next steps

Request a managed migration

Have the X team migrate your AAA subscriptions

XAA introduction

Event types, authentication, and limits

XAA quickstart

Create a subscription and receive events

Event payloads

Sample JSON for every XAA event type