UniPost
Dashboard

Reconnect X Inbox permissions

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

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 the complete requested permission set: tweet.read, tweet.write, users.read, offline.access, dm.read, and dm.write.
  4. Return to UniPost and wait for the account to show Active.
  5. Call capabilities again. Require an empty missing_scopes array 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 are still missing. x_monthly_usage_limit_exceeded and x_inbound_daily_cap_exceeded are allowance boundaries and are not fixed by reconnecting. Managed mode consumes UniPost X Credits; workspace_x_app uses your X app access and bypasses the UniPost allowance.

Review the Inbox API overview, then choose the X comments guide or X direct messages guide. Use the X Credits API reference to inspect current boundaries and the X Credits guide to plan managed-X usage.