Skip to main content
Post, read and search on X. Announce a page, then read what comes back.

​
Connecting

In the dashboard, open Connectors, find Twitter/X and press Connect. You will be sent to sign in; the connection is saved once that succeeds.

​
What you will need

​
Getting the credential

  1. Apply for Twitter Developer Account
  2. Create a new app in Developer Portal
  3. Important: Enable OAuth 2.0 in your app settings
  4. Go to your app’s Keys and tokens tab
  5. Under OAuth 2.0 Client ID and Client Secret:
    • Copy Client ID
    • Copy Client Secret
  6. Optionally generate Bearer Token (for read-only app-context operations)
  7. Configure OAuth 2.0 Settings:
    • Add redirect URLs
    • Request appropriate scopes for your use case

​
Notes

  • X has two credential styles and they are not interchangeable: OAuth 2.0 (client id and secret, user context) is what posting needs; a Bearer token alone is read-only.
  • Posting needs the tweet.write, tweet.read and users.read scopes. “Insufficient scope” means the app has them but the token was issued before they were added — re-authorise.
  • Free-tier write limits are low enough that a burst of posts will be refused. Twitter has strict rate limits. Key limits include:
  • Tweet creation: 300 tweets per 15-minute window
  • User lookups: 75 requests per 15-minute window
  • Search: 180 requests per 15-minute window
  • Timeline: 75 requests per 15-minute window

​
What an agent can do with it

​
Useful resources