X (Twitter)
Connect X so Metric Vault can post text, photos, a GIF or a video to your timeline, what you approve, how the connection renews, and the 280-character rule.
Last updated 2026-09-16
Summary#
Connecting X lets Metric Vault post to your X timeline, immediately or on a schedule: text, up to 4 photos, a GIF, or a video. X asks you to approve reading posts, writing posts, uploading media, reading your profile, and keeping the connection active between sessions. The connection renews itself when you publish. Connecting is free; publishing costs 1 credit for each channel that accepts the post. X has a hard length limit inside Metric Vault: the composer will not publish a post over 280 characters to X.
The channel is labelled X in the Connected channels list.
Purpose#
X rewards frequency and timing more than any other channel, which makes it the one people most want to queue in advance. The connection exists so a post drafted in Metric Vault can go out on its own schedule, alongside the same content adapted for other channels, without a second tab.
The 280-character check happens in the composer, before anything is sent, so a long draft is caught while you can still give X its own shorter text.
Requirements#
- A Metric Vault account you are signed in to. Connecting works on every plan; publishing needs a paid plan and available credits. See Connecting social accounts.
- An X account.
- The
Xrow must showConnectrather thanSetup needed. See Connecting social accounts. - Nothing extra in the browser: the authorization screen opens in the same tab, so no popup permission is needed.
Permissions#
Any signed-in user can connect their own X account. There is no role gate, and the connection is personal: teammates do not inherit it.
X asks you to approve these.
| What you approve | What it allows |
|---|---|
| Read posts from your timeline | Read access that X pairs with write access |
| Post and delete posts for you | Publish the posts you send |
| Read your profile information | Read your name, handle and profile picture, so the connection can be labelled |
| Stay connected to your account until you revoke access | Issue a renewal token, so the connection can renew itself |
Metric Vault only ever uses this to create the posts you send. It does not read your timeline, follow accounts, send messages, or delete anything.
Navigation Path#
Dashboard → Account & Team → Integrations
The connect control is in the Connected channels card. Publishing happens at Dashboard → Marketing → Social Dashboard.
Step-by-Step Guide#
- Open
Integrationsfrom the sidebar, underAccount & Team. - In
Connected channels, find theXrow. - Check the status.
Not connectedmeans you can proceed.Setup neededmeans X is not configured for this site, and pressingConnectwill say so rather than opening X. Report it. - Press
Connect. X's authorization screen opens in the same tab. - Sign in to X if you are not already, and confirm the account shown at the top of the screen is the one you want to post from.
- Review the permission list and press
Authorize app. - The page shows
X connectedwith your account, then returns to Integrations by itself. X has one account per login, so there is no account list to choose from. - The
Xrow now shows your display name, or your handle if X returned no name, and aDisconnectbutton.
What you can do once connected#
Build a post in Create a post on the Social Dashboard, select the X card, and press Publish now or schedule it. On success the channel shows Posted with View post, which links to the published post. The full walkthrough is in Publishing and scheduling posts.
What X can publish#
| Post type | What it takes |
|---|---|
| Post | Text only, up to 280 characters |
| Images | 1 to 4 photos, JPEG, PNG or WEBP, up to 5 MB each, with optional text |
| GIF | One GIF up to 15 MB, with optional text |
| Video | One MP4 or MOV video up to 20 minutes, with optional text |
Automatic picks the type from the files in the post. A post cannot mix photos and a video on X; give X its own files if the rest of the post does.
Photos and video are uploaded to X in parts and X processes a video before it can be posted, so a video post shows Uploading and Processing before Posted.
Reconnect to post media#
Posting media needs X's media.write permission, which Metric Vault has requested since 2026-09-16. An X connection made before then shows Reconnect to post media on its card, and a post with photos or video reports Reconnect this channel to post photos or video. It was connected before media posting was available. Text posts keep working. Press Disconnect, then Connect, to add the permission.
The 280-character rule#
With X selected, the composer shows a counter for X under the text, for example 96 / 280. Over 280, X's checks show The text is longer than this channel allows. with the count, and Publish now stays unavailable. Shorten the text, or open the X tab and tick Use different text on this channel to give X a shorter version while the other channels keep the long one.
Renewal#
X access lasts a short time, about two hours. When you publish and the stored access is within 5 minutes of expiring, Metric Vault renews it first using the renewal token X issued at connect. You do not see this happen. If the renewal fails, the channel fails with a message to reconnect.
Tips#
- Give X its own text when you post to several channels. It has the shortest limit, so a separate version keeps the long post intact elsewhere.
- Count links as characters here. Metric Vault counts the raw text you typed. X shortens links on its own side, so a post that Metric Vault holds back at 290 characters might have fitted on X. Shorten X's text.
- Emoji and accented characters count. The check is on the text in the box, and some emoji count as two.
- Keep photos in the order you want. X shows up to four in the order they sit in the tray.
Limitations#
- Text, up to 4 photos, one GIF or one video. Polls, quote posts, replies and threads are not supported, and a long piece cannot be split into a thread.
- No alt text on X. Alt text you write is sent to the channels that accept it.
- 280 characters, checked before sending.
- Media needs a connection made on or after 2026-09-16. Older connections post text only until reconnected.
- No replies, reposts, likes or deletions. Posts are only ever created.
- Nothing is read back. No impressions, likes or replies are returned to Metric Vault. The
Social Analyticstool measures public data and does not use this connection. - Disconnecting removes every X account stored for you, not only the one shown in the row.
Troubleshooting#
| Symptom | Likely cause | Fix |
|---|---|---|
Row shows Setup needed | X is not configured for this site | Report it. Nothing in your account causes this |
Pressing Connect shows X is not set up yet. An admin needs to add … followed by credential names | The same situation | Report it |
Could not start the connection. Please try again. | The single-use connect link could not be created | Reload the page and press Connect again |
X denied the connection: access_denied | You cancelled on the authorization screen | Press Connect and approve |
This connection link is invalid or was already used. Please start again. | The request was consumed, usually by a second attempt | Press Connect once and complete it |
The connection flow expired (over 15 minutes). Please start again. | Too long between starting and approving | Start again and finish in one go |
The text is longer than this channel allows. in the X checks | The text is over 280 characters | Shorten it, or give X its own text on the X tab |
The connection to this channel has expired. Reconnect it and try again. | X no longer accepts the stored connection, and it could not be renewed | Press Disconnect, then Connect, then Retry failed |
X rejected the post. or a message from X | X refused the specific post | Read X's message. Duplicate text and posting-rate limits are the usual causes |
This tool needs a paid plan. Free includes the 13 technical SEO tools; upgrade to Pro to unlock the rest. | Publishing is not included on Free | Upgrade to publish |
Reconnect to post media on the X card | The connection was made before media posting | Press Disconnect, then Connect |
X could not process this file. or a message from X about the media | X refused the photo or video while processing it | Check the format and length, then retry |
| You connected the wrong account | X was already signed in to another account | Press Disconnect, sign out of X in the browser, then Connect again |
This network would not accept the post: the account we publish through could not be charged for it... | X answered with HTTP 402, so it would not charge our developer account for the call. The usual causes are an empty credit balance, the spend cap for the billing cycle, or a payment method that was declined | Nothing on your side, and it is not your credits. Press Retry failed once it is cleared |
| A scheduled X post is under Needs attention | The connection could not be renewed, a file was refused, X would not charge our developer account, or your plan or credits did not cover it | Read the reason listed under the post in Posts |
FAQs#
Does it post to X or to Twitter? They are the same service. The app labels the channel X.
Can I post a thread? No. Each post is sent on its own, and there is no way to chain them.
Can I attach photos or a video? Yes. Up to 4 photos, a GIF, or one video. An X connection made before 2026-09-16 needs reconnecting first.
Why was my post rejected at 290 characters when X would have accepted it? Metric Vault counts the characters you typed. X shortens links on its side, so a link-heavy post can be under X's effective limit while over the raw count. Give X its own shorter text on the X tab.
Does it cost credits? Connecting is free. Publishing costs 1 credit for each channel that accepts the post, and needs a paid plan. See Connecting social accounts.
Can my teammates publish through my X connection? No. Connections belong to the account that made them.
Do I have to reconnect X regularly? Usually not. The connection renews itself when you publish. You only reconnect if X refuses the renewal, for example after you revoke Metric Vault in X's settings.
What happens to posts I already published if I disconnect? Nothing. They stay on X. Only the ability to publish new ones from Metric Vault is removed. See Disconnecting an integration.
See also
Was this article helpful?
Thanks — feedback noted for the docs team.