Skip to main content

​
X (Twitter)

Connect your X (formerly Twitter) account to Soku to post tweets with text, images, and videos directly from your dashboard. Soku uses OAuth 2.0 with PKCE for authentication and authorization. For media uploads, Soku also uses OAuth 1.0a as required by the X API.

​
Prerequisites

Before connecting X to Soku, make sure you have the following:
  • An X (Twitter) account
  • The ability to log in to X via a web browser
Both free and premium X accounts can be connected to Soku. No special account type is required.

​
Connecting X (Twitter)

  1. Log in to your Soku dashboard at mysoku.io.
  2. Go to Settings > Integrations.
  3. Find X (Twitter) in the list of platforms and click Connect.
  4. You will be redirected to X’s authorization page. Log in to your X account if prompted.
  5. Review the permissions Soku is requesting and click Authorize app.
  6. You will be redirected back to Soku. Your X account will now appear under your connected integrations.

​
What You Can Publish

Content TypeSupported
Text tweetYes
Image tweet (up to 4 images)Yes
Video tweetYes
ThreadNo (single tweet only)

​
Connection Details

  • Auth method: OAuth 2.0 with PKCE (OAuth 1.0a for media uploads)
  • Token type: Access token with refresh token (automatically refreshed by Soku)
  • Data stored at: users/{uid}/integrations/x
  • Automation: Toggle enabled_for_repost in your integration settings to allow automated reposting to this account
Soku automatically refreshes your X tokens before they expire. Background sweeps run periodically to ensure your connection stays active.

​
Troubleshooting

​
”Authorization failed” or redirect error

Make sure you are logged in to the correct X account before authorizing Soku. If you are logged in to multiple X accounts in your browser, X may use the wrong one. Log out of all X accounts first, then try connecting again.

​
Tweets fail to post

Check the following:
  • Your X account is not locked, suspended, or restricted.
  • The tweet content does not exceed X’s character limit (currently 280 characters for free accounts, 25,000 for Premium+ subscribers).
  • If including media, the file meets X’s media requirements. See Media Formats & Limits.

​
Media upload fails but text posts work

Soku uses OAuth 1.0a specifically for media uploads to X, as required by the X API. If media uploads fail, try disconnecting and reconnecting your X account to refresh both OAuth 2.0 and OAuth 1.0a credentials.

​
”Rate limit exceeded” error

X enforces strict API rate limits. If you are publishing a high volume of tweets in a short period, you may hit these limits. Wait 15 minutes and try again.

​
Connection lost after changing X password

Changing your X password invalidates all active tokens. Go to Settings > Integrations in Soku and reconnect your X account.
If you revoke Soku’s access from your X account settings (under Settings > Security and Account Access > Apps and Sessions > Connected Apps), you will need to reconnect in Soku.