Common Errors
This guide covers the most common errors you might encounter when using Upload-Post and how to resolve them. Errors are organized by category to help you quickly find solutions.
Session Expired
Session and authentication errors occur when the connection between Upload-Post and your social media account has been broken. This is usually easy to fix by reconnecting your account.
Common Session Errors
| Error Message | Platform | Solution |
|---|---|---|
| "Your [Platform] session has expired" | All | Reconnect your account |
| "Token expired and refresh failed" | All | Reconnect your account |
| "The session has been invalidated because the user changed their password" | Facebook/Instagram | Reconnect after password change |
| "Error validating access token" | Facebook/Instagram | Verify permissions and reconnect |
| "Your X session has expired and could not be refreshed" | X (Twitter) | Reconnect your X account |
| "User has not authorized application" | Various | Grant permissions and reconnect |
| "Unauthorized" | Various | Reconnect your account |
How to Fix Session Errors
-
Go to Manage Users
-
Find the affected account - Look for accounts with warning indicators
-
Disconnect the account - Click the disconnect/remove button next to the account
-
Reconnect the account - Click "Connect" and complete the authorization flow
-
Grant all permissions - Make sure to approve all requested permissions during reconnection
If you recently changed your password on a social media platform, you'll need to reconnect that account in Upload-Post.
Account Blocked
These errors occur when there's an issue with your account on the social media platform itself. Upload-Post cannot fix these - you need to resolve them directly on the platform.
Common Account Status Errors
| Error Message | Platform | What It Means |
|---|---|---|
| "Sessions for the user are not allowed because the user is not a confirmed user" | Account needs verification | |
| "The YouTube account of the authenticated user is suspended" | YouTube | Account suspended by YouTube |
| "Your account is temporarily locked" | X (Twitter) | X has locked your account |
| "The Instagram account is restricted or inactive" | Instagram has restricted your account | |
| "Action suspected as spam. Activity is restricted" | Spam detection triggered | |
| "The user used for authentication is suspended" | Various | Account suspended on platform |
How to Fix Account Blocked Errors
These issues must be resolved directly on the social media platform:
Facebook/Instagram Account Not Confirmed
- Go to facebook.com and log in
- Check for any verification prompts or security notices
- Go to Settings & Privacy > Settings > Personal Details
- Verify your email and phone number are confirmed
- Visit Facebook Account Quality to check for restrictions
- After resolving issues, reconnect in Upload-Post
X (Twitter) Account Locked
- Go to twitter.com or x.com and log in
- Follow the prompts to unlock your account (may require phone verification)
- Once unlocked, reconnect in Upload-Post
YouTube Account Suspended
- Go to YouTube and sign in
- Check the YouTube Help Center for suspension appeals
- Follow YouTube's process to restore your account
Instagram Restricted
- Open the Instagram app and log in
- Look for any notification banners or prompts
- Follow Instagram's instructions to verify your identity
- After restrictions are lifted, reconnect in Upload-Post
Upload-Post cannot bypass platform restrictions. You must resolve these issues directly with the social media platform before reconnecting.
Configuration & Permissions
These errors occur when your account is connected but requires additional configuration or permissions.
Common Configuration Errors
| Error Message | Platform | Solution |
|---|---|---|
| "No Facebook Pages found for your account" | Connect a Facebook Page (personal profiles not supported) | |
| "Multiple Facebook Pages found. Please select a Page" | Select which Page to post to | |
| "Facebook Page ID is required for text posts" | Configure your profile to select a Page | |
| "Couldn't get a Facebook Page access token for Page ID..." | Reconnect with proper Page permissions | |
| "Pinterest account not found or not configured" | Configure Pinterest in your profile | |
| "Board not found" | Select a valid Pinterest board | |
| "You are not permitted to access that resource" | Various | Check your role/permissions on the account |
| "This site doesn't allow you to save Pins" | The target site blocks Pinterest pins | |
| "quote_tweet_id cannot be used when uploading media to X. Remove it and retry." | X (Twitter) | Quote tweets and media are mutually exclusive — drop quote_tweet_id or remove the media |
| "X rejected this reply (403)... not permitted to reply to this author on X's Pay-Per-Use tier" | X (Twitter) | Reply to an author the account has engaged with (this is a platform restriction, not a session error — reconnecting won't help) |
How to Fix Configuration Errors
Facebook Page Issues
Facebook requires you to post to a Facebook Page, not a personal profile. The Facebook API does not support posting to personal profiles.
-
Create a Facebook Page (if you don't have one):
- Go to Create a Page
- Follow the setup wizard
-
Connect your Page to Upload-Post:
- Go to Manage Users
- Disconnect your Facebook account
- Reconnect and select the Page you want to post to
- Make sure you have Admin or Editor role on the Page
-
Select the correct Page in your profile:
- Go to your Upload-Post profile settings
- Select the Facebook Page from the dropdown
To post to a Facebook Page, you need:
- Admin or Editor role on the Page
- Grant "pages_manage_posts" permission during connection
- Grant "pages_read_engagement" permission
Pinterest Board Issues
- Make sure you have at least one board in your Pinterest account
- Go to your Upload-Post profile and select the correct board
- If the board was recently created, try disconnecting and reconnecting Pinterest
Content Format
These errors occur when your media doesn't meet the platform's requirements for size, format, or aspect ratio.
Common Content Errors
| Error Message | Platform | Solution |
|---|---|---|
| "Unsupported image size" | Various | Use supported dimensions |
| "Invalid image aspect ratio" | Use ratio between 4:5 and 1.91:1 | |
| "Video longer than 2 minutes" | X (Twitter) | Shorten video or upgrade X account |
| "TikTok rejected the media format" | TikTok | Use MP4/MOV format |
| "One or more tags are invalid" | Various | Remove special characters from tags |
| "Your post must contain post flair" | Add required flair to your post | |
| "Media could not be fetched from the provided URL" | Various | Use a publicly accessible URL |
| "Downloaded file is too small" | Various | Check URL points to valid media |
| "Collaborator usernames are invalid" | Use valid public usernames without @ |
Media Requirements by Platform
| Platform | Image Format | Max Image Size | Video Format | Max Video Duration |
|---|---|---|---|---|
| JPG, PNG | 8 MB | MP4, MOV | 60 min (Feed), 90 sec (Reels) | |
| JPG, PNG, GIF | 10 MB | MP4, MOV | 240 min | |
| TikTok | - | - | MP4, MOV | 10 min |
| X (Twitter) | JPG, PNG, GIF | 5 MB | MP4 | 2 min 20 sec* |
| JPG, PNG | 8 MB | MP4 | 10 min | |
| YouTube | - | - | MP4, MOV, AVI | 12 hours |
| JPG, PNG | 32 MB | MP4, MOV | 15 min |
*X Premium users may have longer video limits
Instagram Aspect Ratio Guidelines
- Square: 1:1
- Portrait: 4:5 (recommended for Feed)
- Landscape: 1.91:1
- Stories/Reels: 9:16
Images outside the 4:5 to 1.91:1 range will be rejected.
For best results, use 1080x1350 pixels (4:5 ratio) for Instagram feed posts.
Fixing Media URL Issues
If you're getting "Media could not be fetched" errors:
- Check the URL is publicly accessible - Open it in an incognito browser window
- Don't use private/restricted URLs - Google Drive links must be set to "Anyone with the link"
- Use direct file URLs - The URL should end with a file extension like
.jpgor.mp4 - Check file size - Very small files (< 1KB) often indicate a broken link
Rate Limits
These errors occur when you've hit posting limits or the platform is experiencing temporary issues.
Common Rate Limit Errors
| Error Message | Platform | Solution |
|---|---|---|
| "Daily upload limit exceeded for this channel" | YouTube | Wait until tomorrow (UTC midnight) |
| "Service Unavailable (503)" | Various | Retry in a few minutes |
| "Temporary issue. We retried 4 times but it still failed" | Platform issue - retry later | |
| "Fatal" / "Unexpected error" | Various | Platform issue - retry later |
| "Rate limit reached" | Various | Wait before making more requests |
Platform Daily Limits
| Platform | Daily Posting Limit |
|---|---|
| ~50 posts per day | |
| TikTok | 15-20 videos per day |
| ~150 posts per day | |
| 25 pins per day | |
| Varies by subreddit | |
| YouTube | 30 videos per day |
TikTok Spam-Risk Errors
TikTok enforces per-account anti-spam caps on API posting. These are rolling 24-hour limits on your TikTok account, not an Upload-Post restriction — no retry or reconnect can lift them early.
| Error | What it means | How to fix |
|---|---|---|
spam_risk_too_many_pending_share | Your TikTok account has reached the cap of 5 unpublished (pending) inbox drafts in 24 hours. This happens when videos are sent to the TikTok inbox but never published from the app. | Open the TikTok app and publish or discard your pending drafts (Inbox → System notifications), then wait for the 24h window to roll. |
spam_risk_too_many_posts | Your TikTok account reached its daily API posting cap (typically ~15 posts per day per account; the exact number varies per creator). | Wait for the rolling 24h window. Spread posts across the day or across accounts. |
spam_risk_user_banned_from_posting | TikTok has banned this account from posting via API. | Contact TikTok support from the affected account. |
Upload-Post parks restricted accounts. After one of these verdicts, Upload-Post stops sending that TikTok account to TikTok for a while and answers new uploads immediately with error_code: "account_restricted", failure_stage: "precheck", restriction_reason, restricted_until and retry_after_seconds (the credit is refunded). Windows: spam_risk_user_banned_from_posting → 7 days, spam_risk_too_many_posts → 1 hour (TikTok's limit is rolling, so we only pause long enough to stop retries). Post-level verdicts (spam_risk_text, spam_risk) and the inbox-draft backlog (spam_risk_too_many_pending_share) never park the account — fix the text / publish the drafts and retry. The account owner also receives an email when the account is parked, and reconnecting the TikTok account in Upload-Post clears the pause (for example after TikTok support lifted the restriction). Don't re-queue a parked account before restricted_until: the request will not reach TikTok anyway.
Official TikTok references: Content Sharing Guidelines · Content Posting API — Upload Video
If your posts are being delivered to the TikTok inbox (for example while the daily active-user cap fallback is active), remember to publish them from the app — 5 unpublished drafts will block further uploads for 24h with spam_risk_too_many_pending_share.
Bluesky Requirements
| Error | What it means | How to fix |
|---|---|---|
"Bluesky requires a verified email before uploading videos" (unconfirmed_email) | Bluesky-hosted accounts must have a verified email before the video service accepts uploads. Only the account owner can verify it. | In the Bluesky app: Settings → Account → Email → Verify, then retry the upload. |
| "Bluesky supports a maximum of 4 images per post" | The AT Protocol schema hard-limits image posts to 4 images. | Split the post or reduce the selection to 4 images. |
Official Bluesky references: Video uploads · Creating posts
Handling Rate Limits
- Wait and retry - Most limits reset at midnight UTC
- Spread posts throughout the day - Avoid posting many items at once
- Use scheduling - Schedule posts to spread them out automatically
- Check your usage - View your posting history to track activity
When you hit a daily limit, Upload-Post may automatically reschedule your post for the next day. Check your scheduled posts to confirm.
Getting Help
If your error isn't listed here or you need additional assistance:
- Check our FAQ for general questions
- Review our API Error Handling Guide for technical details
- Contact support at [email protected]
When contacting support, please include:
- The exact error message you received
- The platform you were posting to
- The type of content (text, photo, video)
- When the error occurred
Platform Help Centers
If you need to resolve issues directly with a social media platform: