Connection Issues
This page covers common problems with connecting and maintaining social media platform accounts in Soku, and how to resolve them.
OAuth Authorization Failures
If the OAuth flow fails when you try to connect a platform:
Pop-up blocked
Many browsers block pop-up windows by default. The OAuth authorization flow opens in a new window or pop-up.
Fix: Allow pop-ups from mysoku.io in your browser settings, then try connecting again.
Browser extension interference
Ad blockers, privacy extensions, and script blockers can interfere with OAuth redirects.
Fix: Temporarily disable browser extensions (or try an incognito/private window) and attempt the connection again.
Occasionally the social media platform itself may be experiencing issues.
Fix: Wait a few minutes and try again. Check the platform’s status page to see if there is a known outage.
Wrong account selected
If you have multiple accounts on a platform (personal and business, for example), you may have authorized the wrong one.
Fix: Disconnect the account in Settings > Integrations, then reconnect and make sure to select the correct account during the OAuth flow.
Expired Tokens
Soku stores authorization tokens for each connected platform and automatically refreshes them in the background. However, there are situations where a token can expire and cannot be refreshed automatically.
Why tokens expire
| Reason | Description |
|---|
| Password change | If you change your password on the social media platform, your existing token is invalidated. |
| Revoked access | If you remove Soku’s access from the platform’s “Connected Apps” or “Third-party apps” settings, the token is revoked. |
| Platform policy change | Some platforms periodically invalidate tokens for security reasons. |
| Refresh failure | In rare cases, the automatic token refresh may fail due to a temporary platform API outage. |
How to tell if a token has expired
Go to Settings > Integrations and check the token status indicator for each connected account:
| Status | Meaning |
|---|
| OK (green) | Token is valid. No action needed. |
| Warning (yellow) | Token may expire soon or a minor issue was detected. |
| Danger (red) | Token has expired or been revoked. Re-authorization is required. |
How to fix an expired token
- Go to Settings > Integrations.
- Find the account with the red status indicator.
- Click Re-authorize (or Connect again).
- Complete the OAuth flow on the platform’s authorization page.
- The status should return to OK (green).
If you have scheduled posts targeting an account with an expired token, those posts will fail when they attempt to publish. Re-authorize the account as soon as possible to avoid missed posts.
Automatic Token Refresh
Soku runs background token refresh processes to keep your connections active. Here is how token refresh works for each platform:
| Platform | Refresh Method | Notes |
|---|
| Instagram | Managed by Meta | Uses long-lived tokens with automatic renewal. |
| TikTok | Automatic refresh | Soku refreshes tokens before they expire. |
| YouTube | Automatic refresh | Uses Google OAuth refresh tokens. |
| Facebook | Long-lived token | Soku exchanges short-lived tokens for long-lived ones. |
| X (Twitter) | Automatic refresh | Uses OAuth 2.0 with PKCE and refresh tokens. |
| Threads | Managed by Meta | Same token infrastructure as Instagram. |
| LinkedIn | Managed by LinkedIn | Long-lived tokens with periodic renewal. |
Social media platforms enforce their own API rate limits, separate from Soku’s rate limits. If a platform temporarily blocks requests from Soku due to high volume, you may see temporary publishing failures.
Symptoms:
- Posts fail with a platform-specific rate limit error.
- Multiple posts to the same platform fail in quick succession.
- Publishing succeeds again after waiting a short time.
How to fix:
- Wait and retry. Platform rate limits are temporary and usually reset within minutes.
- Space out your posts. If you are publishing many posts to the same platform in a short window, consider spreading them out over a longer period.
- Check the platform’s API documentation for specific rate limit details if you are publishing at high volume.
Soku handles platform rate limits gracefully when possible and will automatically retry failed publishes in many cases.
Re-authorization Needed
There are several situations where you may need to re-authorize a connected account:
| Situation | Action |
|---|
| Token status is red (Danger) | Re-authorize the account in Settings > Integrations. |
| Platform changed its permissions | Disconnect and reconnect the account to grant updated permissions. |
| Switched to a different platform account | Disconnect the old account and connect the new one. |
| Platform experienced an outage | Wait for the platform to recover, then re-authorize if the status does not return to green. |
Still Having Connection Problems?
If you have tried the steps above and are still unable to connect or maintain a platform connection:
- Try a different browser or device.
- Check if the platform is down on their official status page.
- Contact Soku support with the platform name, your account email, and a description of the error you are seeing.
Related Pages
