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.
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.
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.
- Best if linked to a Facebook Page — linking enables full publishing features.
- 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.
- For full publishing features, link your Instagram account to a Facebook Page.
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. |
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. Switching away from and back to the Connections page, or refreshing the browser, clears the stuck state automatically.Automatic token refresh
Connected Facebook and Instagram accounts are checked hourly for expiring tokens. If a token is close to expiring, Socializioz refreshes it automatically in the background — no action needed from you. If an automatic refresh fails, you receive a notification prompting you to reconnect the account manually. This prevents silent publishing failures caused by expired credentials.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
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.
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. |
| Instagram not linked to a Page | Your Instagram Business or Creator account is not connected to a Facebook Page. | In the Instagram app, go to Settings > Account > Linked Accounts and connect a Facebook Page, then reconnect in Socializioz. |
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. |