Socializioz supports seven social platforms. Five are available today — Facebook, Instagram, TikTok, X, and LinkedIn — with Telegram and WhatsApp coming soon. Connect your accounts from the Connections page in your workspace.Documentation Index
Fetch the complete documentation index at: https://docs.socializioz.com/llms.txt
Use this file to discover all available pages before exploring further.
This page covers initial setup and OAuth flows. For day-to-day account management — health monitoring, reconnecting, disconnecting, and troubleshooting — see the connections management page.
Supported platforms
| Platform | Plan availability | Status |
|---|---|---|
| All plans | Available | |
| All plans | Available | |
| TikTok | Professional and above | Available |
| X (Twitter) | Professional and above | Available |
| Professional and above | Available | |
| Telegram | Professional and above | Coming soon |
| Enterprise only | Coming soon |
Telegram and WhatsApp integrations are not yet available. They appear on the Connections page with a “Coming soon” label. You will be notified when they launch.
Platform capabilities
Not every feature is available on every platform. The table below shows what you can do with each connected account inside Socializioz.| Capability | TikTok | X (Twitter) | |||
|---|---|---|---|---|---|
| Publish and schedule posts | Yes | Yes | Yes | Yes | Yes |
| View post feed in account details | Yes | Yes | No | No | No |
| Inline comment previews | Yes | Yes | No | No | No |
| Engagement stats (reactions, comments, shares) | Yes | Yes | No | No | No |
| Refresh and sync content | Yes | Yes | No | No | No |
| Comment management | Yes | Yes | No | No | No |
| Direct messages (inbox) | No | Yes | No | No | No |
| Analytics and metrics | Yes | Yes | Yes | Yes | Yes |
For TikTok, X, and LinkedIn, the account details panel shows basic connection info only. Full post feeds, inline comment previews, and engagement stats within account details are currently available for Facebook and Instagram accounts.
How to connect an account
Select a platform
Choose the platform you want to connect. If your plan does not include that platform, you will be prompted to upgrade.
Follow the setup guide
For Facebook and Instagram, a guided setup sheet appears before the OAuth flow starts. It walks you through platform-specific requirements — such as switching to a Business or Creator account — with step-by-step instructions and direct links to the relevant settings.
- On mobile, the Instagram guide includes a deep link that opens the Instagram app directly.
- On desktop, a QR code lets you continue the setup process on your phone.
Authorize access
You are redirected to the platform’s login page. Sign in and grant Socializioz the required permissions. On mobile devices, Meta (Facebook and Instagram) authorization opens in the same tab to ensure compatibility across all browsers, including Safari, Chrome, WebView, and PWA environments. Other platforms also open in the same tab or a new tab depending on your browser. See how mobile OAuth works for details.
Confirm Instagram (if applicable)
When you connect Facebook, Socializioz checks whether a professional Instagram account is linked to your Facebook Page. If one is found, a confirmation dialog appears showing the Instagram account’s profile picture, username, follower count, and the linked Facebook Page name. The dialog also lists the permissions Socializioz needs (publish content, manage posts and insights) and a reminder that Instagram posts require an image or video.Click Confirm & Connect Instagram to add the Instagram account alongside your Facebook Page in a single flow, or click Cancel to skip and connect only Facebook.
Connection complete
After authorization (and Instagram confirmation, if applicable), a branded confirmation page appears in your browser showing whether the connection succeeded or encountered an issue:
- Success — a green checkmark, the platform name (for example, “Instagram connected!”), and a confirmation message appear along with a Return to SocializioZ link.
- Error — a warning icon and a brief description of the problem appear with the same return link.
Pre-connect setup guides
Facebook and Instagram show a guided setup sheet before the OAuth flow begins. The sheet explains platform requirements, checks that your account is ready, and provides direct links to fix any issues.Facebook setup sheet
The sheet confirms two requirements before you proceed:- You manage a Facebook Page — the connection works with Pages, not personal profiles. You must have Admin or Editor permissions on the Page.
- Use the Facebook account that owns or manages that Page — sign in with the account that has the correct role.
Instagram setup sheet
The sheet confirms two requirements:- Instagram must be Business or Creator — personal accounts are not supported. You need to switch to a Professional account in the Instagram app.
- Publishing depends on Instagram Platform eligibility — Socializioz connects your Instagram account as an isolated professional account using Instagram Business Login. Publishing capabilities and checks may differ from Facebook-linked accounts. Meta documents this flow separately from the traditional Facebook Page-linked authorization.
- On mobile: a deep-link button opens the Instagram app directly, with the navigation path displayed as breadcrumb chips: Profile > Menu > Settings and activity > Account type and tools > Switch to professional.
- On desktop: a QR code links to Instagram login so you can complete the switch on your phone. The sheet stays open while you make the change.
Other platforms
TikTok, X (Twitter), and LinkedIn proceed directly to authorization with no pre-connect sheet. No special prerequisites are required — sign in and authorize Socializioz.Telegram and WhatsApp
Platform-specific requirements
- You must manage a Facebook Page (not a personal profile).
- You need Admin or Editor permissions on that Page.
- If you do not have a Page yet, create one on Facebook before connecting.
- Your Instagram account must be a Business or Creator account. Personal accounts are not supported.
- To switch: open the Instagram app and go to Profile > Menu > Settings and activity > Account type and tools > Switch to professional.
- Socializioz connects Instagram as an isolated professional account using Instagram Business Login. A Facebook Page link is not required.
- Publishing support depends on your account’s Instagram Platform eligibility. Some publishing capabilities may differ from accounts connected through the traditional Facebook-linked flow.
TikTok
No special prerequisites. Sign in with your TikTok account and authorize Socializioz.X (Twitter)
No special prerequisites. Sign in with your X account and authorize Socializioz.Quick-compose from a connected account
Each connected account card on the Connections page includes a compose button. Tap it to open the composer with that account pre-selected, so you can start drafting a post without selecting the account manually.Troubleshooting connection errors
When a connection attempt fails, an error banner appears at the top of the Connections page with a description of the problem and a Fix with AI Support button. That button opens the support page with the platform name and error code pre-filled so the AI assistant can diagnose the issue faster. For a full list of error codes and resolutions, see the connection error reference below.Connection status indicators
Each connected account shows a status indicator on its card:| Indicator | Meaning |
|---|---|
| Green dot | Healthy — the token is valid and the account is ready to publish. |
| Amber dot with “Needs reconnect” | The token has expired, been revoked, or the account needs re-authorization. Tap the card and follow the reconnect prompt. |
Publish capability
Each connected account displays a publish capability status that indicates whether the account is ready to publish content. This is determined by the account’s connection method and permissions:- Publish-capable — the account was connected through the current Instagram Business Login flow and has the required publishing permissions. You can publish content to this account.
- Not publish-capable — the account was connected using an older method that does not support publishing, or your account does not meet Instagram’s Platform eligibility requirements. Reconnect the account from the Connections page to enable publishing.
Instagram accounts connected before this update may show as not publish-capable. Reconnect these accounts from the Connections page to use the Instagram Business Login flow. Publishing support depends on your account’s Instagram Platform eligibility.
Stuck connecting spinner
If the connection flow appears stuck (the spinner keeps spinning after you return from the platform), it usually means the OAuth redirect did not complete. The page detects when you return to the app — via tab focus, page visibility, or app switch — and automatically clears the spinner and refreshes your account list. If the spinner persists:- On desktop — switch away from and back to the Connections page, or refresh the browser.
- On mobile — switch to another app and back. The app detects the return and refreshes the account list automatically.
- On iOS PWA — close the PWA from the app switcher (swipe up), then reopen from the home screen.
Empty account list after connecting on mobile
On mobile devices, the account list may briefly appear empty after you complete an OAuth flow. This happens when the session token has not finished restoring before the page requests your account data. The app automatically refreshes the account list when you return to catch any server-side delay. This should resolve within a few seconds. If the list stays empty, pull down to refresh or switch away from and back to the Connections tab.Automatic token refresh
Connected Facebook and Instagram accounts are checked automatically for expiring tokens. The refresh process works as follows:- Check frequency — Socializioz checks all Meta (Facebook and Instagram) account tokens once per hour in the background.
- Refresh window — if a token will expire within the next 7 days, the app attempts to refresh it automatically. No action is needed from you.
- Expired token alert — if a token has already expired and cannot be refreshed, you see a one-time toast notification per session for each affected account, prompting you to reconnect manually.
- Failure handling — if the automatic refresh service is temporarily unavailable, the app backs off for 30 minutes before retrying. After three consecutive failures, automatic refresh is paused for the rest of your session to avoid unnecessary retries.
Automatic token refresh applies only to Meta (Facebook and Instagram) accounts. Other platforms (TikTok, X, LinkedIn) require manual reconnection when their tokens expire.
Managing connected accounts
Viewing account details
Each connected account card shows:- Profile picture — the account’s avatar (or the first letter of the name as a fallback)
- Account name and username — the display name and @username
- Platform badge — colored badge identifying the platform
- Status dot — green for active, amber for needs reconnect
- Action buttons — create post (opens the composer with this account pre-selected), reconnect (if expired), and expand/collapse
- Media preview, caption, and published date
- Engagement stats (reactions, comments, shares)
- A Refresh content button to sync the latest posts
- Inline comment previews with a link to view all comments on the platform
read_insights or pages_read_engagement scopes were not granted), an amber warning banner appears at the top of the details panel. Reconnect the account and approve all requested permissions to resolve this.
For TikTok, X, LinkedIn, and Telegram, the details panel shows a placeholder indicating that full details are coming soon.
On mobile, the details panel slides in from the right (or left in Arabic/RTL mode). On desktop, it appears as a side sheet. You can also deep-link directly to a specific account on mobile by adding ?account=<account-id> to the Connections page URL — the details panel opens automatically for that account.
Meta token debug panel (admin only)
If your account has the admin role, Facebook and Instagram account details include a Meta Token Debug section. This collapsible panel helps diagnose permission and token issues without leaving the app. The debug panel shows:| Section | What it shows |
|---|---|
| Granted scopes | Each required OAuth scope displayed as a badge — green if granted, red if missing |
| Connected pages | Facebook Pages linked to the token, with an indicator showing whether each page has a valid access token |
| Token timestamps | When the token was connected and when it expires |
pages_show_list, pages_read_engagement, pages_read_user_content, pages_manage_posts, instagram_basic, instagram_content_publish, and business_management. If any scope is missing, the panel header shows an amber shield icon instead of green.
The Meta Token Debug panel is only visible to admin accounts. Regular workspace members do not see it. Use this tool when troubleshooting why a Meta account cannot publish, why analytics data is missing, or why engagement stats are not loading.
Disconnecting an account
Open the account card
Find the account you want to disconnect on the Connections page and expand its card.
Reconnecting an expired account
When an account’s token expires or is revoked, an amber Reconnect button appears on its card. The account is flagged for reconnection when any of the following conditions are true:- The access token has passed its expiration date
- The account status is expired, invalid, revoked, disconnected, error, or needs_reconnect
- The platform reported an error during a sync or publish attempt
Find the account
Look for accounts with an amber status dot and the label “Needs reconnect” on the Connections page.
Re-authorize on the platform
You are redirected to the platform’s OAuth consent screen. Sign in and approve all requested permissions — the same flow you followed when first connecting the account.
Plan limits
The number of social accounts you can connect depends on your plan:| Plan | Account limit |
|---|---|
| Free | 1 |
| Starter | 5 |
| Professional | Unlimited |
| Enterprise | Unlimited |
- A Full badge appears in the connection panel header.
- All platform connect buttons are disabled.
- A message reads “You reached the current plan limit.”
When connecting Facebook, the system may link multiple accounts in one flow. A single Meta OAuth authorization can connect both a Facebook Page and an associated Instagram account simultaneously.
Connections during onboarding
When you reach the connections step during onboarding, the page shows a prompt to connect at least one account before continuing. After connecting, a Continue onboarding button appears to take you back to the onboarding flow. If the OAuth redirect interrupts the onboarding, the page remembers your intent and shows the continue option when you return.Mobile connections
On mobile, the Connections page is accessible directly from the Connections tab in the bottom navigation bar. It supports pull-to-refresh — swipe down from the top of the account list to reload connection statuses. On desktop, the page redirects to the workspace connections canvas view automatically.How mobile OAuth works
How the OAuth authorization opens depends on your device and how you access Socializioz:- Mobile Safari — for Meta (Facebook and Instagram) connections, the authorization flow opens in the same tab. After you approve permissions, you are redirected back to the Connections page automatically. Other platforms also open in the same tab.
- WebView or PWA — the authorization page opens in the same tab to avoid popup-blocking issues. After you approve permissions, you are redirected back to the Connections page automatically.
- Android Chrome — the authorization page opens in a new tab. After approval, you are redirected back to Socializioz.
Meta (Facebook and Instagram) OAuth always uses same-tab navigation on mobile, regardless of the browser or context. This avoids popup-blocking issues and ensures a consistent experience across Safari, Chrome, WebView, and PWA environments.
Multi-workspace reconnection on mobile
If you manage multiple workspaces and need to reconnect a Meta (Facebook or Instagram) account on mobile, the OAuth flow preserves your active workspace context throughout the process. You do not need to worry about switching workspaces before or after the reconnection — the flow stays tied to the workspace you started from, even if the browser redirects to an external authorization page and back.Mobile connection tips
- Complete the OAuth flow without interruption. Do not close the browser or lock your device while the authorization page is open.
- On mobile (Meta connections): the authorization opens in the same tab. Stay on the page until the flow completes and you are redirected back automatically.
- Look for the auto-redirect. After authorization, a branded confirmation page shows whether the connection succeeded or failed. The page redirects you back to Socializioz automatically within a few seconds. If the redirect does not happen, tap Return to SocializioZ.
- Accounts refresh automatically. When you return to the app, the Connections page detects your return and refreshes the account list. Newly connected accounts typically appear within a few seconds.
- Use pull-to-refresh as a fallback. If accounts do not appear after returning, swipe down on the Connections page to force a reload.
- iOS users: if the connection appears stuck, close the Socializioz PWA completely (swipe up in the app switcher) and reopen it. The account should appear on the Connections page.
Connection error reference
The tables below list all error codes you may encounter during connection, grouped by category. Each error includes the raw code shown in the URL or error banner, the cause, and what to do.General OAuth errors
| Error code | Cause | What to do |
|---|---|---|
no_code / missing_code | No authorization code was received from the platform. | Retry the connection. Make sure you complete the full authorization flow without closing the browser. |
missing_state / invalid_state | The OAuth callback could not be verified, often caused by opening the flow in multiple tabs. | Close extra tabs and reconnect from a single browser tab. |
invalid_state_data | The OAuth session data was corrupted in transit. | Start the connection process again from the Connections page. |
session_expired / state_expired | You took too long to complete the OAuth flow, or the browser session was interrupted. | Start the connection process again. Complete it within a few minutes. |
server_config / server_misconfigured | A temporary configuration issue on the Socializioz side. | Wait a few minutes and try again. If it persists, contact support. |
missing_params | Authorization parameters were incomplete. | Retry the connection. If the error repeats, contact support. |
missing_credentials | Platform credentials are not configured. | Contact support — this is a server-side issue. |
token_exchange_failed | The platform did not return a valid access token. | Try again. If the error persists, clear your browser cookies for the platform and retry. |
access_denied | You cancelled the authorization or the platform rejected the request. | Retry the connection and complete the full authorization flow. |
Meta (Facebook and Instagram) errors
| Error code | Cause | What to do |
|---|---|---|
missing_permission | You declined one or more permissions during the OAuth flow. The error message names the specific missing permission. | Go to Facebook Settings > Business Integrations, remove Socializioz, then reconnect and approve all requested permissions. |
| No Pages found | Your Facebook account does not manage any Pages, or you did not select a Page during OAuth. | Create a Facebook Page first, then reconnect. |
Missing pages_manage_posts | The publishing permission was not granted. | Remove Socializioz from Facebook Business Integrations, reconnect, and approve all permissions. |
IG_DIRECT_NOT_PUBLISHABLE | Your Instagram account was connected using an older method that does not support publishing. | Reconnect the account from the Connections page. The current flow uses Instagram Business Login and grants publishing permissions based on your account’s Platform eligibility. |
X (Twitter) errors
| Error code | Cause | What to do |
|---|---|---|
x_token_error | The token exchange with X failed. | Check that you completed the authorization. If the error persists, try clearing browser cookies for X and retry. |
no_access_token | X did not return an access token after authorization. | Retry the connection. Make sure you click Authorize app on the X consent screen. |
token_parse_failed | The response from X could not be parsed. | Retry the connection. If it persists, contact support. |
invalid_client | App credentials could not be verified by X. | This is usually temporary. Wait a few minutes and try again, or contact support. |
TikTok errors
| Error code | Cause | What to do |
|---|---|---|
invalid_token_response | TikTok returned a response that could not be parsed during token exchange. | Retry the connection. If the error persists, clear your browser cookies for TikTok and try again. |
missing_token_fields | TikTok’s response was missing the access token or user identifier. | Retry the connection. Make sure you complete the full authorization on TikTok’s consent screen. |
token_creation_failed | The connection succeeded on TikTok’s side but could not be saved in Socializioz. | Retry the connection. If it keeps failing, contact support. |
social_account_creation_failed | Your TikTok account was authorized but could not be added to your workspace. | Retry the connection. If the error repeats, contact support. |
TikTok may also return its own error codes (such as
invalid_grant or invalid_client) during the token exchange. These codes are passed through directly in the error banner. Retry the connection or contact support if the error is unclear.LinkedIn errors
| Error code | Cause | What to do |
|---|---|---|
user_cancelled_login | You closed the LinkedIn login page before completing sign-in. | Retry the connection and complete the full sign-in process. |
user_cancelled_authorize | You declined to grant permissions on the LinkedIn authorization screen. | Retry the connection and click Allow on the consent screen. |
linkedin_token_error | The token exchange with LinkedIn failed. | Retry the connection. If the error persists, clear your browser cookies for LinkedIn and try again. |
no_access_token | LinkedIn did not return an access token after authorization. | Retry the connection. Make sure you complete the full authorization flow. |
linkedin_profile_error | Socializioz could not fetch your LinkedIn profile after authorization. | This is usually a temporary LinkedIn API issue. Wait a few minutes and retry. |
invalid_profile | LinkedIn returned a profile response that was missing required fields. | Retry the connection. If it persists, contact support. |
token_creation_failed | The connection succeeded on LinkedIn’s side but could not be saved in Socializioz. | Retry the connection. If it keeps failing, contact support. |
Mobile-specific issues
| Problem | Cause | What to do |
|---|---|---|
| Account list is empty after connecting | On mobile, the app needs to restore your session before fetching accounts. This can take a few seconds, especially on iOS. | Switch back to the app and wait a few seconds — the app automatically refreshes the account list when it detects you returned from OAuth. If the account does not appear, pull down to refresh. |
| OAuth redirect lands on a blank page | The browser lost the redirect URL during the OAuth flow. | Close the blank page and return to Socializioz. Your account may already be connected — check the Connections page. If not, retry the connection. |
| Connection succeeds but the spinner does not stop | The OAuth callback completed but the app did not detect the return. | Switch to another app and back to trigger the auto-refresh. If the spinner persists, close the Socializioz PWA from the app switcher and reopen it. |
| ”Session expired” error on mobile after OAuth | Your login session timed out while you were on the platform’s authorization page. | Sign in to Socializioz again and retry the connection. Complete the authorization within a few minutes to avoid session timeouts. |
| Connected account disappears after closing and reopening the app | The OAuth redirect may not have fully completed before the app was closed. | Reopen the app and check the Connections page. If the account is missing, reconnect it. |
| Meta reconnect lands in the wrong workspace on mobile | An older version of the app could lose workspace context during the OAuth redirect. | Update to the latest version. The OAuth flow now preserves your active workspace context throughout the reconnection process. |
| ”Storage unavailable” or session not persisting on mobile | Your browser’s local storage is full, disabled, or blocked by privacy settings. The app now handles this gracefully instead of failing silently. | Clear your browser data for Socializioz, or check that cookies and site data are allowed in your browser privacy settings. On iOS, go to Settings > Safari > Advanced > Website Data and remove the Socializioz entry, then try again. |
Related
- Connections — monitor account health and manage connected accounts day-to-day
- Getting started — workspace setup and onboarding wizard
- Post composer — create posts for your connected accounts
- Troubleshooting — resolve connection and publishing errors
- Privacy and data — revoking third-party access on each platform
- Plans and billing — platform availability and account limits by plan