Connecting Accounts

How Connections Work

Social connections in Social Studio are per pen name. Each pen name has its own social workspace, so your different author identities never cross wires.

StorytellerOS connects to your social accounts through secure OAuth, run by Reader Radius, the publishing engine that powers Social Studio:

• You authorize the publishing engine to post on your behalf
• We never see or store your social media passwords
• You can revoke access anytime from the platform's app settings
• Logins expire from time to time. When a platform disconnects you get an email and an in-app notification, and the affected account shows a needs-reconnect badge. Scheduled posts to that platform may fail until you reconnect it

Supported Platforms

Connecting an Account

1. Go to Social Studio → Accounts and pick the pen name at the top right
2. Under Connect a platform, click the platform's tile
3. Read the short checklist of what to have ready, then click Continue
4. The platform's login opens in a new tab. Log in and authorize StorytellerOS
5. Come back to the Accounts tab. Your account appears under Social accounts

Ad accounts connect the same way from the Ad accounts section on the same page, and your Shopify store from the Shopify store section.

Platform-Specific Notes

Facebook

• You must have a Facebook Page (not personal profile)
• You need admin access to the Page
• Select which Page(s) to connect
• Personal profiles cannot be connected

Instagram

• Must be a Business or Creator account
• Must be linked to a Facebook Page
• Connect through Facebook authorization
• Personal accounts cannot be connected

TikTok

• Creator or Business account required
• Videos must be uploaded directly
• Some features may require approval from TikTok

Twitter/X

• Connect with your Twitter account
• Standard tweet features available
• API limitations may apply

LinkedIn

• After you sign in, choose where posts go: your personal profile or a Company Page you manage
• Company Pages need admin access; your personal profile is always offered
• Text posts and images supported

Pinterest

• Business account recommended
• Select which boards to post to
• Pin scheduling with images

Threads

• Connects through Instagram/Meta
• Must have Threads profile
• Text and image posts

Bluesky

• Uses an App Password, not your main password
• Make one in Bluesky under Settings → Privacy and Security → App Passwords
• Paste your handle and the App Password into the Bluesky connect window; no new tab opens
• Text and image posts supported

Telegram

• Click Get my code in the Telegram connect window
• Open the connection bot from the link and send it the code
• Add the bot as an admin of the channel or group you want to post to
• The window updates on its own once the code arrives

Connecting Multiple Accounts

If you have multiple pen names, each one keeps its own connections:

1. Pick the pen name at the top of the Accounts page
2. Connect that pen name's accounts
3. When creating posts, select which account to use

On the same page, Account groups save sets of accounts you often post to together, and Facebook Pages chooses which of your Pages this pen name posts to.

This keeps your author identities separate on social media.

Managing Connections

Viewing Connected Accounts

1. Go to Social Studio → Accounts
2. Each account shows Working, Login expires in N days, or Needs reconnecting
3. Facebook, X, TikTok, YouTube, Bluesky and Reddit renew their own logins, so they keep showing Working as a renewal date comes near. You only need to reconnect one if it shows Needs reconnecting or we email you
4. Click Details on an account to see any missing permissions or problems the platform reported
5. Click Check again after reconnecting in another tab

If we've emailed you that an account needs reconnecting, a red notice stays at the top of the list and that account shows Needs reconnecting until you reconnect it, even if its quick check passes.

Refreshing a Connection

1. Find the account marked Needs reconnecting (or the red notice)
2. Click Reconnect
3. Authorize again

Disconnecting an Account

1. Find the account in the list
2. Click the trash icon
3. Confirm Disconnect

Troubleshooting Connections

Connection Failed

• Make sure pop-ups are not blocked
• Try a different browser
• Check that you are logged into the platform
• Verify account requirements (business account, etc.)

Connection Expired

• Logins expire from time to time. Meta especially does not publish a schedule, and tokens can last anywhere from a few weeks to a few months
• You will see an in-app banner when a connection needs to be refreshed
• Scheduled posts for that platform pause (not fail) until you reconnect, so nothing is lost
• Reconnect using the steps above. It takes about 30 seconds

Posts Failing

• Check connection status
• Reconnect if expired
• Check platform-specific requirements
• Verify content meets platform guidelines

Wrong Account Connected

• Disconnect the wrong account
• Log out of that account in your browser
• Connect the correct account

Security Notes

• We do not store passwords: signing in on the platform means we never see your credentials
• Limited permissions: we only request posting permission
• You control access: revoke access from platform settings anytime
• Secure transmission: all data encrypted in transit

Best Practices

• Connect business accounts: platforms give them more posting options
• Check connections weekly: before they expire unexpectedly
• Test after connecting: send a test post to verify
• Keep platforms updated: platform changes can affect connections
• Have backup posting method: know how to post manually if needed