Connect your X (Twitter) account

Step-by-step OAuth flow for connecting an X account to Unison.

Updated May 12, 2026·1 min read

Connecting X takes about thirty seconds. Unison uses OAuth 2.0 with PKCE so credentials never leave the X authorisation flow.

  1. 1

    Open Settings → Channels and click Add channel.

  2. 2

    Pick X / Twitter from the network grid. You will be redirected to x.com to authorise.

  3. 3

    Approve the request. The scopes you grant are: read your profile, post on your behalf, and read your replies (for the unified inbox).

  4. 4

    You land back inside Unison. The new account appears in your channel list with a green dot if Unison can reach the API.

Connecting more than one X account? Repeat the flow for each one. Unison treats them as independent channels in the composer.

What gets stored

The OAuth refresh token is encrypted with AES-256-GCM before it touches our database. Your password is never seen by Unison and you can revoke access from your X security settings at any time.

Common errors

  • invalid_request: unsupported response type usually means your X account has API access disabled. Switch to a Premium plan and try again.
  • Callback fails on first connect is almost always a clock-skew issue on your device. Make sure your system time is set automatically.

Was this helpful?