➕ Connecting an X Account

Connecting an X account takes one authorization: you pick the workspace, approve the X authorization, and Fren One starts monitoring immediately. There is no bot to install and no verification step: the X account itself becomes a channel in your workspace.

Before you start

• Decide which workspace should own the account. A workspace groups your channels, team, and settings. See the Workspaces docs for how workspaces, teams, and billing fit together.
• You need to be the Owner or an Admin of that workspace: the wizard only lists workspaces you can manage.
• Either have access to the X account yourself, or know who does: the authorization happens on X, signed in as that account. If someone else holds the login, you can send them an invite link instead (see below).

Connect an account

1. Open your workspace in the Fren One webapp. In the sidebar under Channels, select Connect a channel (or pick it from the workspace switcher). If you're starting fresh, open the workspace switcher and select Create or join a workspace instead: the same wizard runs with a workspace-naming step first.
2. On the platform step, choose X: the card reads "Connect an X account to monitor its activity and mentions."
3. When adding to an existing workspace, pick it in the "Add to workspace" selector. Only workspaces you can manage are listed.
4. Choose "Authorize Fren One to access this account directly" if you have direct access to the account. (If someone else controls it, see Have someone else authorize below.) Review the authorization card. Under "Authorizing allows Fren One to:" it spells out exactly what you're granting:
   • Read the account's public profile and posts
   • Publish posts you schedule in Fren One, and nothing else
5. Select Connect with X. You're sent to X to approve the authorization, then returned to the wizard. Log in to X as the account you want to connect: X delegate access can't be used to authorize another account. The account is created and assigned to your workspace automatically: there are no further steps.

Have someone else authorize

If someone else in your organization holds the account's X login, choose "Have another user authorize Fren One to access this X account" on the same step:

1. Optionally enter the account's X handle. It's only for your reference: the link connects whichever account authorizes it.
2. Select Create invite link and copy the link. For security it's shown only once.
3. Send the link to the account holder. When they authorize on X, logged in as that account, the account is added to the workspace you selected automatically and you get a notification. You can close the wizard in the meantime.

Pending invite links are listed with their expiry date and status (Pending, Connected, Expired or Revoked). Revoke stops a link from being used.

Posting only happens when you schedule it

The authorization covers publishing, but Fren One only ever posts what someone schedules or sends from the 📆 Messages queue. If posting permission is later lost on X's side, the queue shows Reconnect your X account until someone reconnects it.

Gathering your first stats

On success, the wizard runs a first sync right away so your dashboard isn't blank, showing its progress as it goes: "Connecting to X…", "Fetching follower count…", "Pulling recent mentions…", "Setting up your dashboard…". When it completes, result pills summarize what it found: "{count} followers" and "{count} mentions found".

If the sync takes longer than the wizard waits, you'll see "Your X account is connected. Your stats will finish syncing shortly." instead: the data catches up on its own.

Re-connecting an account that's already in the same workspace is safe: the wizard reports "This X account is already connected to this workspace. We've refreshed the connection."

When your data arrives

• Immediately on connect: profile details, follower count, and recent mentions (with sentiment) from the first sync.
• Within roughly two hours: the full picture arrives with the recurring sync that runs about every two hours: follower-change tracking, reply-based signals, and Listening results.

If authorization fails

Message	What it means
"This X account may already be managed in Fren One. Ask your team for an invite."	The account is already connected somewhere. If it belongs to a teammate's workspace, ask them for an invite to that workspace.
"This workspace has reached its X account limit."	The workspace can't hold another X account. Connect it to a different workspace, or review your plan.
"X authorization failed. Please try again."	A transient error during the X authorization. Run the wizard again.

Who can configure the account

Unlike Discord and Telegram, X has no per-channel verification, because X can't tell us who legitimately holds an account. Access is decided inside Fren One instead:

• The Owner and Admins manage everything: connecting accounts, Listening, Brand Voice, and composing in the Messages.
• Members holding the + X grant manage the same configuration surfaces. Connecting, claiming and unlinking an account stays with the Owner and Admins, because bringing an account into a workspace is workspace management rather than X configuration.
• Other workspace members can view the Overview statistics and the scheduler queue, but the configuration surfaces show a lock naming the missing grant: "Requires the X grant. Ask a workspace owner or admin."

See Capability Grants for how the + X grant is assigned.

Staff-connected accounts

Fren One staff can connect an account by handle, without the account holder authorizing anything. These accounts carry an "Unverified · monitoring only" badge on the Overview and are monitoring-only: statistics and mentions work, but nothing that requires the account's own authorization.

Troubleshooting

Troubleshooting

No data on the dashboard yet?

• The first sync starts the moment you connect: give it a minute, then refresh the Overview.
• Follower-change alerts, reply-based signals, and Listening results wait for the recurring sync, which runs roughly every two hours. An empty dashboard right after connecting is normal.

The account shows as needing reconnecting?

• You'll see an "X account needs reconnecting" alert in your workspace inbox, and the Messages shows a "Reconnect your X account" banner. Reconnect from there: scheduled posts stay queued until posting resumes.

The wizard says the account may already be managed?

• Someone (possibly a teammate) has already connected it. Ask your team for an invite to the workspace that holds it: Fren One won't reveal which workspace that is.

Related features

• 📊 Statistics: What the Overview shows once your first sync lands
• 📆 Messages: Compose and schedule the posts this authorization lets Fren One publish
• 📡 Listening: Set up keyword and account monitoring beyond your own mentions