Quickstart

Set up activity stream subscriptions and receive events

This guide walks you through setting up activity stream subscriptions to receive real-time account activity events.

Prerequisites

Before you begin, you’ll need:

• A developer account with an approved App
• Your App’s Bearer Token

---

1. Create a subscription

   Subscribe to a user’s activity events:

   cURL

   curl -X POST "https://api.x.com/2/activity/subscriptions" \
     -H "Authorization: Bearer $BEARER_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "user_id": "2244994945",
       "event_types": ["tweet_create_events", "favorite_events", "follow_events"]
     }'
   

   Python

   import requests
   
   bearer_token = "YOUR_BEARER_TOKEN"
   
   url = "https://api.x.com/2/activity/subscriptions"
   headers = {
       "Authorization": f"Bearer {bearer_token}",
       "Content-Type": "application/json"
   }
   payload = {
       "user_id": "2244994945",
       "event_types": ["tweet_create_events", "favorite_events", "follow_events"]
   }
   
   response = requests.post(url, headers=headers, json=payload)
   print(response.json())
   

   Response:

   {
     "data": {
       "id": "1234567890",
       "user_id": "2244994945",
       "event_types": ["tweet_create_events", "favorite_events", "follow_events"],
       "created_at": "2024-01-15T10:00:00.000Z"
     }
   }
   
2. Connect to the stream

   Open a persistent connection to receive events:

   cURL

   curl "https://api.x.com/2/activity/stream" \
     -H "Authorization: Bearer $BEARER_TOKEN"
   

   Python

   import requests
   
   bearer_token = "YOUR_BEARER_TOKEN"
   
   url = "https://api.x.com/2/activity/stream"
   headers = {"Authorization": f"Bearer {bearer_token}"}
   
   response = requests.get(url, headers=headers, stream=True)
   
   for line in response.iter_lines():
       if line:
           print(line.decode("utf-8"))
   
3. Process incoming events

   Events stream as JSON objects:

   {
     "for_user_id": "2244994945",
     "event_type": "tweet_create_events",
     "created_at": "2024-01-15T10:30:00.000Z",
     "tweet_create_events": [
       {
         "id": "1234567890",
         "text": "Hello from the stream!",
         "author_id": "2244994945"
       }
     ]
   }
   

---

Available event types

Event	Description
tweet_create_events	User posts a new Post
favorite_events	User likes a Post
follow_events	User follows or is followed
direct_message_events	User sends or receives a DM
block_events	User blocks or unblocks
mute_events	User mutes or unmutes

---

Manage subscriptions

List subscriptions

Get all active subscriptions:

curl "https://api.x.com/2/activity/subscriptions" \
  -H "Authorization: Bearer $BEARER_TOKEN"

Update a subscription

Modify event types for a subscription:

curl -X PUT "https://api.x.com/2/activity/subscriptions/1234567890" \
  -H "Authorization: Bearer $BEARER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "event_types": ["tweet_create_events", "favorite_events"]
  }'

Delete a subscription

Remove a subscription:

curl -X DELETE "https://api.x.com/2/activity/subscriptions/1234567890" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

Next steps

Account Activity API

Webhook-based alternative

API Reference

Full endpoint documentation