🚨Error Reference
This page contains all Blotato error messages and their explanations. Use your browser's search function (Ctrl+F or Cmd+F) to find your specific error.
API Errors
Authorization failed - please check your credentials
Double check your Blotato API key. Use the n8n/Make official Blotato nodes for easier setup. You don't have to worry about copy/pasting IDs or raw JSON code. See tutorial: https://help.blotato.com/api/n8n/n8n-basics
Wrong Blotato API Key
Check you've copied the API key correctly without whitespaces. Verify the blotato-api-key variable is populated correctly in the UPLOAD step.
URL is empty
The URL being passed is empty. Check that previous step finished creating your video/carousel. Increase WAIT time if needed and verify you have enough credits.
Wrong Account ID
Check you've copied the social account ID correctly. Verify accountId variable in PUBLISH step is correctly populated.
Wrong Page ID
Facebook requires both Account ID and Page ID. Check you've copied Page ID correctly using the "Copy Page ID" button.
Invalid File Format
Check your file format is valid per social platform requirements.
Invalid Video Dimensions
Video dimensions not supported by platform. Test with this sample video: https://database.blotato.io/storage/v1/object/public/public_media/4ddd33eb-e811-4ab5-93e1-2cd0b7e8fb3f/videogen-4c61a730-7eb2-47e9-a3a3-524740a1b877.mp4
reached_active_user_cap
Account not properly warmed up. Follow warm-up guide before connecting to Blotato.
You Ran Out Of AI Credits
Go to Settings > Billing to check and add credits.
Wrong Template Parameters
Each video template has different parameters. Check API docs for correct template parameters.
Missing AI Voice
POV template doesn't include AI voice. Use empty template ID for AI voiceover.
Missing Music
Add autoAddMusic: true parameter in PUBLISH TO TIKTOK step for music.
Wrong Heygen API Key and IDs
Check you've copied HEYGEN AVATAR ID correctly, not the Avatar GROUP ID.
You're On Heygen Free Plan
HeyGen API requires $99/mo API plan. Free API plan won't work.
Your Avatar Has a Background
Set matting to false and remove background section for default avatar background.
Invalid JSON Error
Validate JSON at jsonlint.com and compare with Blotato API docs.
The service is receiving too many requests from you
Rate limit exceeded. Upload Media: 10 requests/minute. Publish Post: 30 requests/minute.
The aspect ratio is not supported
Video aspect ratio not supported by platform. Check platform requirements.
body/template/id must be equal to constant
Pass template object with id. See API examples for correct format.
mediaURL is null or empty
Video not done. Increase wait time or check if you have AI credits.
Please review our URL ownership verification rules
TikTok rejects URL. Upload media first, then use Blotato URL to post.
Tiktok's servers may be experiencing issues. This is a retryable error
TikTok server issue or posting too frequently. Wait and retry.
Threads API Feature Not Available: This user does not have access to this Threads API feature
Link Instagram account to Threads. Warm up Threads account for a few days with posts before connecting to Blotato.
Failed to read media metadata. Is the file accessible and a valid media file?
Check that your file is publicly accessible by opening it in an incognito browser. If uploading from Google Drive, ensure your URL is in the format described here: https://help.blotato.com/api/api-reference/upload-media-v2-media#upload-google-drive
Connection Errors
400 Session Error Connecting Instagram Account
Sometimes connection succeeds despite error. Test with a post first. If not, use incognito browser, log out of other accounts, log into only the target account, then reconnect.
Unable to connect LinkedIn company page
Verify you're an Admin of the page. Use incognito browser, log into social account, then Blotato, and reconnect.
YouTube Unauthorized error
Use incognito browser. Log into YouTube, then Blotato. Reconnect account. Update YouTube account ID in automation workflows.
Unable to connect social account (general)
Use incognito Chrome browser. Log into social account first, then Blotato. Connect account.
Platform-Specific Errors
The user has exceeded the number of videos they may upload (YouTube)
YouTube upload limit reached. Wait 24 hours. Check API quota in Google Cloud Console. Verify account.
TikTok views consistently < 50
Account likely shadowbanned. Start fresh with new account.
TikTok views consistently ~200
TikTok doesn't know your video topic. Use niche keywords in title, description, and audio.
Single TikTok video stuck at low views
Change video privacy to PRIVATE, close app, reopen, switch back to EVERYONE.
TikTok account banned
Account not warmed up properly. Follow warm-up guide. Don't post more than 3x/day via API. Stay active on account.
Escape Multi-Line Paragraphs error
Long text with linebreaks needs escaping. In n8n use toJsonString() function.
Brand New Account error
Account not warmed up. Don't connect 3rd party apps until account is established with manual posts.
Account Limits
TikTok (Starter Plan)
3 unique accounts per 24h, 10 posts per account
Limit applies to Starter plan only. Creator and Agency plans unrestricted.
50 posts per day per account
Hard limit per 24-hour window.
10 pins per day per account
Account must be validated by Blotato team. Email [email protected] for validation.
YouTube
Variable based on channel age
New channels have low API quota. Can still upload via YouTube website.
Troubleshooting Steps
General Connection Issues
Open incognito Chrome browser
Log out of all other accounts
Log into target social account only
Log into Blotato
Connect account
API Issues
Check Failed dashboard: https://my.blotato.com/failed
Verify API keys copied correctly without spaces
Check you have sufficient AI credits
Validate JSON at jsonlint.com
Compare your request with API documentation
Account Health Issues
Warm up new accounts manually for several days
Post organically before connecting to Blotato
Stay active on account (reply to comments, engage)
Don't exceed platform posting limits
Use platform-appropriate content formats
Last updated
Was this helpful?