X (Twitter)

Category: Social
Connect by: Connect with OAuth
Official API docs: https://developer.twitter.com/en/docs/twitter-api

What the agent can see

None.

What the agent can do

Capability	API call	Risk	Needs approval
Publish a tweet (text, optional pre-uploaded media_ids). (docs)	POST /2/tweets	🔴 high	✅ yes

Connecting it

• You provide: OAuth 2.0 user access token (tweet.write)
• Where to get it: developer.twitter.com → Projects & Apps → create app → enable OAuth 2.0 → run the PKCE user-authorization flow with scopes tweet.read tweet.write users.read offline.access → store the access token.
• Permissions/scopes: tweet.read, tweet.write, users.read, offline.access

Account setup

• Account needed: An X account + a developer account.
• App registration: Create a Project + App, enable OAuth 2.0 (PKCE), set redirect URI, request tweet.write.
• Verification required: Write access to POST /2/tweets requires a PAID API tier (Basic ~$200/mo at time of writing).
• Testing: No free sandbox for posting; validate read scopes on the Free tier, but posting needs Basic+.

Limits

Per-app + per-user limits; POST /2/tweets is capped per 24h by access tier. HTTP 429 with x-rate-limit-reset on exceed.