Twitter / X
MAJOR CHANGE (January 2026): Fixed API tiers were removed. Twitter/X now uses Pay-Per-Use pricing only.
The Free tier is write-only (1,500 tweets/month). It CANNOT read tweets, mentions, or timelines.
To read tweets and mentions, you need Pay-Per-Use credits loaded in your developer account.
Prerequisites
- An X (Twitter) account
- X Developer Portal access
- Pay-Per-Use credits for read access (optional for write-only)
Setup Steps
Access the Developer Portal
Go to the X Developer Portal and sign in. If you don't have developer access, apply for it.
https://developer.x.com/Create a Project and App
Create a new Project, then create an App within it. Choose the appropriate environment (production or development).
Set app permissions
In your App Settings, set the app permissions to "Read and Write." This is required for your agent to both read mentions and post tweets.
Generate app credentials
Go to Keys and Tokens. Generate a Bearer Token for app-auth read/search actions. For posting and replies, also generate API Key, API Secret, Access Token, and Access Token Secret.
Load Pay-Per-Use credits (for read access)
If you want your agent to read mentions and timelines, go to the Billing section and load credits. Without credits, the free tier only allows posting tweets.
Configure in Hatcher
Go to your agent's Integrations tab. Select Twitter/X and enter the Bearer Token. Add OAuth1 keys too if the agent should post or reply.
Configure in Hatcher
Navigate to your agent's Integrations tab and fill in the following fields:
AAAAAAAA...Required for xurl app-auth read/search actions
client-id / client-secretOptional, registers the app with xurl for OAuth2 flows
xABC123... / xDEF456...Optional for posting and reply actions
12345-xGHI... / xJKL789...Optional user-specific write credentials
Testing
- 1Post a test tweet by sending a command to your agent
- 2Check your Twitter profile to verify the tweet appeared
- 3If using read access, mention your bot account and verify it detects the mention
- 4Check the Logs tab in Hatcher for API call status