This endpoint has been updated to include Post edit metadata. Learn more about these metadata on the "Edit Posts" fundamentals page.
This endpoint is often used with the Direct Messages endpoints. We have launched new v2 Direct Messages endpoints. Note that the Enterprise and Premium Account Activity APIs support v2 one-to-one messages, but do not yet support group conversations.
Overview
Enterprise
The Account Activity API provides you the ability to subscribe to realtime activities related to a user account via webhooks. This means that you can receive realtime Posts, Direct Messages, and other account events from one or more of your owned or subscribed accounts through a single connection.
You will receive all related activities below for each user subscription on your webhook registration:
Activity types | |
---|---|
|
|
Please note - We do not deliver home timeline data via the Account Activity API. Please use the GET statuses/home_timeline to pull this data.
Video Series
Check out our four-part video series on the Account Activity API to get up to speed!
Today we announced the Account Activity API is generally available as a premium and enterprise API. 🔔 pic.twitter.com/xnlF9kPevi
— Twitter Dev (@TwitterDev) May 16, 2018
Feature summary
Tier | Pricing | Number of unique subscriptions | Number of webhooks | Reliability and Activity Recovery |
---|---|---|---|---|
Enterprise | Contact sales | Up to 500+ | 3+ | Retries and Replay |
Next steps
- Apply for access and get started with webhooks.
- Check out our API references to find the right endpoint for the job.
- Follow this step-by-step tutorial on how to get started with the Account Activity API.
- Follow this step-by-step tutorial on how to build a customer engagement application on X.
- Have questions? Running into errors?
- Read our Frequently asked questions or Error Troubleshooting guide.
- Read our Frequently asked questions or Error Troubleshooting guide.
- Explore our sample code:
- Enterprise Account Activity API dashboard, a node web app that displays webhook events using the enterprise tier of the Account Activity API and includes Replay functionality.
- The SnowBot chatbot, a Ruby web app built on the enterprise Account Activity and Direct Message APIs.