UniPost
Dashboard

Reconnect X permissions

Diagnose the account-specific X capability, correct workspace-app credentials when needed, then repeat OAuth so UniPost receives the current scopes.

X comments use OAuth 2.0. Reconnect for missing comment permissions only when the account capability reports reconnect_required.

Keep the workspace API key server-side and derive external_user_id from the authenticated app user. Use inbox_scope=workspace only for an owner/admin aggregate.

1. Inspect the exact capability state

Call GET account capabilities. Read x_inbox.app_mode, missing_scopes, missing_app_credentials, reconnect_required, and delivery_status. Inbox requires the Basic plan or higher; paused_plan is fixed by plan eligibility, not OAuth.

2. Complete workspace X app credentials

Skip this step for unipost_managed_app. For workspace_x_app, open Dashboard → Settings → Platform Credentials → X / Twitter and save all four values: Client ID, Client Secret, app Bearer Token, and Consumer Secret. Saving only the OAuth client keeps publishing available but leaves X Inbox delivery disabled. API users can use the Platform Credentials reference.

3. Reconnect the account

  1. Open Dashboard → Project → Accounts.
  2. Find the affected X / Twitter account and choose Reconnect.
  3. On X, approve tweet.read, tweet.write, users.read, and offline.access.
  4. Return to UniPost and wait for the account to show Active.
  5. Call capabilities again. Require an empty missing_scopes array for the feature currently available to the workspace and the needed comments or DM capability to be true.

4. Verify list, reply, and sync

Start with read-only calls. The exact contracts are in List Inbox, Reply to Inbox, and Sync Inbox. Only send the reply example to a controlled account when you intend to create a real X message.

5. Interpret remaining boundaries

x_reconnect_required means scopes required by an available feature are still missing. x_inbound_daily_cap_exceeded is a safety boundary and is not fixed by reconnecting.

Review the Inbox API overview, then choose the X comments guide.