What you need before you start
- An X account you can sign in to. Any account works; X Premium is not needed.
- X post credits on your plan. X charges for every post sent through its API, so X posts use a monthly allowance: 450 credits on Pro, 1,500 on Agency, shared by your brands. A post costs 1 credit, a post with a link 13, and each post of a thread counts. Unused credits do not carry over. Starter has no X post credits, so posting to X needs Pro or Agency. See Pricing.
- The owner or admin role in the UniPostudio brand you are connecting, and a free channel slot on your plan.
Connect step by step
- Step 1:
Open Channels in UniPostudio.
Choose Channels in the sidebar, or go straight to app.unipostudio.com/channels. Check that you are in the right brand.
- Step 2:
On the X (Twitter) card, select Connect.
A pop-up opens on x.com. If your browser blocks pop-ups, the app says so and opens the same page in this tab.
- Step 3:
Sign in to the X account you want to connect.
X connects whichever account is signed in on x.com in this browser. If it is the wrong one, switch accounts on x.com first.
- Step 4:
Select Authorize app.
X lists what UniPostudio may do (explained below). Authorizing grants all of it; there is nothing to untick.
- Step 5:
Let the pop-up close.
The card says Connected · healthy and shows your @handle.
Once it is connected
X appears in the composer’s channel list. Before you schedule, the composer shows how many X post credits a post will use, so a link (13 credits) never comes as a surprise.
X’s access lasts two hours at a time and UniPostudio renews it in the background: you only reconnect if the card says so.
What we ask permission for, and why
X shows these on its authorization page. Each one is there for a feature; we do not ask for anything else.
tweet.write- Publish the posts and threads you schedule or publish now.
tweet.read- Read posts, which X requires together with posting and reading your profile.
users.read- Your name, @handle and picture, for the channel card and the composer’s preview.
media.write- Upload the images and videos attached to your posts.
offline.access- Stay connected: X’s access lasts two hours, and this lets UniPostudio renew it without asking you to sign in again.
dm.read- Show your direct messages in the inbox.
dm.write- Send the direct-message replies you (or AI replies you turned on) write.
If something goes wrong
“Reconnect X (Twitter) to post images and videos. Text posts keep working.”
This connection was made without the media permission. Select Reconnect on the card and authorize again: images and videos work from then on, and text posts never stopped.
“You declined the X permissions.”
You chose Cancel on X’s page, or closed it. Select Connect again and choose Authorize app.
“Not enough X credits are left this month for this post.”
Your plan’s X post credits for this month are used up, or this post needs more than are left (a link costs 13). Remove the link, wait for next month’s allowance, or move to Agency. Starter has no X post credits at all.
The wrong X account was connected
Open the card’s ⋯ menu and choose Disconnect. On x.com switch to the right account (or sign out), then select Connect again.
X refused a post
X refuses a post with exactly the same text as a recent one, posts from a locked or suspended account, and posts over its rate limits. Change the wording, check the account on x.com, or try again later. The post’s failure message says which it was.
The card says “Expired · scheduled posts are paused”
X ended the access: after a password change, or because UniPostudio was removed in X’s Connected apps. Select Reconnect on the card.
“The connection took too long and expired” or “This connection was started in another browser”
Start again from the card, and finish within 10 minutes in the browser you started in. If your browser blocks cookies for app.unipostudio.com, allow them.
“X (Twitter) is limiting connections for now”
X is rate-limiting sign-ins. Wait a few minutes and try again.
Connect is greyed out
The top of the screen says “Only owners and admins can connect, change or disconnect channels.” Ask an owner or admin of the brand.
What we never do
- We never ask for, see or keep your password. You sign in on the platform’s own page (or paste a token the platform issued you), and the platform gives UniPostudio a token, not your password.
- Every token is encrypted with AES-256-GCM before it is stored, and is never written to our logs.
- We ask only for the permissions the features need, and use each one only for what this page says.
- We never post or reply unless you or a teammate does, or an automation you turned on (scheduled posts, automatic AI replies) does.
- Disconnecting deletes the stored token and what we synced from the account: its messages, comments, feed and analytics.
Disconnect or reconnect
Open the ⋯ menu on the X (Twitter) card (More actions for X (Twitter)), choose Disconnect and confirm. UniPostudio revokes its access at X, deletes the stored tokens, and deletes the messages and analytics synced from the account. Scheduled posts to it are not published until you connect it again.
To reconnect, select Connect on the card again. On x.com you can always see and remove UniPostudio under Settings → Security and account access → Apps and sessions → Connected apps.
Still stuck?
Write to us with the channel’s name and the exact words on the card or in the error message: that is usually enough for us to tell what happened. Never send us a password or a token.