Skip to content
Metric VaultHelp Center
Open app

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 X row must show Connect rather than Setup 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 approveWhat it allows
Read posts from your timelineRead access that X pairs with write access
Post and delete posts for youPublish the posts you send
Read your profile informationRead your name, handle and profile picture, so the connection can be labelled
Stay connected to your account until you revoke accessIssue 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.

Dashboard → Account & Team → Integrations

The connect control is in the Connected channels card. Publishing happens at Dashboard → Marketing → Social Dashboard.

Step-by-Step Guide#

  1. Open Integrations from the sidebar, under Account & Team.
  2. In Connected channels, find the X row.
  3. Check the status. Not connected means you can proceed. Setup needed means X is not configured for this site, and pressing Connect will say so rather than opening X. Report it.
  4. Press Connect. X's authorization screen opens in the same tab.
  5. 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.
  6. Review the permission list and press Authorize app.
  7. The page shows X connected with your account, then returns to Integrations by itself. X has one account per login, so there is no account list to choose from.
  8. The X row now shows your display name, or your handle if X returned no name, and a Disconnect button.
Screenshot
The X authorization screen showing the requested permissions and the Authorize app button.

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 typeWhat it takes
PostText only, up to 280 characters
Images1 to 4 photos, JPEG, PNG or WEBP, up to 5 MB each, with optional text
GIFOne GIF up to 15 MB, with optional text
VideoOne 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.

Screenshot
The X tab in the composer with its own shorter text, the 212 / 280 counter, and a four-photo preview.

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 Analytics tool 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#

SymptomLikely causeFix
Row shows Setup neededX is not configured for this siteReport it. Nothing in your account causes this
Pressing Connect shows X is not set up yet. An admin needs to add … followed by credential namesThe same situationReport it
Could not start the connection. Please try again.The single-use connect link could not be createdReload the page and press Connect again
X denied the connection: access_deniedYou cancelled on the authorization screenPress Connect and approve
This connection link is invalid or was already used. Please start again.The request was consumed, usually by a second attemptPress Connect once and complete it
The connection flow expired (over 15 minutes). Please start again.Too long between starting and approvingStart again and finish in one go
The text is longer than this channel allows. in the X checksThe text is over 280 charactersShorten 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 renewedPress Disconnect, then Connect, then Retry failed
X rejected the post. or a message from XX refused the specific postRead 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 FreeUpgrade to publish
Reconnect to post media on the X cardThe connection was made before media postingPress Disconnect, then Connect
X could not process this file. or a message from X about the mediaX refused the photo or video while processing itCheck the format and length, then retry
You connected the wrong accountX was already signed in to another accountPress 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 declinedNothing on your side, and it is not your credits. Press Retry failed once it is cleared
A scheduled X post is under Needs attentionThe connection could not be renewed, a file was refused, X would not charge our developer account, or your plan or credits did not cover itRead 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?