🚨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. Use the official Blotato n8n/Make nodes for easier setup - you won't need to hardcode API keys manually. See tutorial: https://help.blotato.com/api/n8n/n8n-basics
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
Use the official Blotato n8n/Make nodes - you can select accounts from a dropdown instead of copying IDs manually. See tutorial: https://help.blotato.com/api/n8n/n8n-basics. If not using official nodes: Check you've copied the social account ID correctly from Settings > Social Accounts.
Account [ID] not found
The accountId in your request does not exist for the user/workspace behind your API key. Use the official Blotato n8n/Make nodes to avoid ID errors -- select accounts from a dropdown instead of copying IDs manually. Install guide: https://help.blotato.com/api/start#id-3.-install-the-official-blotato-node. If you are using MCP or an AI coding tool, your AI tool handles account lookup automatically. Point it to: https://help.blotato.com/api/llm
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: 30 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.
scenes.0: missing object
Incorrect JSON format for scenes array in CREATE VISUAL node. Each template has a specific scenes format -- find your template's exact format with examples at Visual Templates. To debug: (1) Select template in n8n/Make, (2) Remove ALL parameters including Prompt, (3) Run the step, (4) Check API Dashboard to see the exact JSON structure your template expects.
slides.image: must be at most 400 characters
The image field expects a short public URL (e.g. https://your-site.com/image.jpg), not a base64 string or data blob. Keep image URLs under 400 characters.
mediaURL is null or empty
Video not done. Increase wait time or check if you have AI credits.
Cannot read properties of undefined (reading 'mediaUrl')
You're trying to publish before the visual/video is finished rendering. After your Create Visual step, add a Get Visual step and wait until the status is "done", then map the mediaUrl into the Publish step's Media URLs field. If the visual creation failed or you ran out of AI credits, the mediaUrl will never be produced.
Please review our URL ownership verification rules
TikTok rejects certain URLs. Try using a different hosting service for your media, or use the optional Blotato Upload endpoint first: https://help.blotato.com/api/api-reference/upload-media-v2-media
Tiktok's servers may be experiencing issues. This is a retryable error
TikTok server issue or posting too frequently. Wait and retry.
Could not refresh TikTok access_token: Service Unavailable
TikTok's servers temporarily rejected the token refresh. Wait 15-30 minutes and retry. If the error persists, reconnect your TikTok account in Settings > Social Accounts.
JSON value expected but got '<' at position 0 (TikTok)
TikTok's API returned an HTML error page instead of a JSON response. This is a temporary TikTok server issue (outage, rate limiting, or maintenance). Your post payload is valid. Retry after a few minutes. If it keeps failing, reconnect your TikTok account in Settings > Social Accounts.
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, set the folder (or the file) to "Anyone with the link" as Viewer. For automation workflows, set the entire folder to public so all files inside inherit the permission. Then use a direct download URL: https://drive.usercontent.google.com/download?id=FILE_ID&export=download&confirm=t
Google Drive virus scan warning popup blocking media access
Google Drive shows virus scan warnings for large files (>25MB typically) or files it cannot scan. This blocks automated access to your media. Solutions: 1) Use the direct download URL format: https://drive.usercontent.google.com/download?id=FILE_ID&export=download&confirm=t which bypasses the warning page. 2) For files >50MB, use a different hosting service like AWS S3, Dropbox, or direct server hosting instead of Google Drive. 3) For automation workflows, consider using cloud storage with proper API access rather than Google Drive shared links.
This error happens when uploading media larger than 15MB via the n8n Upload "Binary Data" option. Switch to URL-based upload. If your videos are regularly larger than 50MB, don't use Google Drive. Use a cloud-based bucket solution such as AWS S3, GCP, or similar solution that allows for easy transfer of large video files.
Base64 data is too large, maximum size is 20MB
This error happens when uploading media larger than 15MB via the n8n Upload "Binary Data" option. Switch to URL-based upload. If your videos are regularly larger than 50MB, don't use Google Drive. Use a cloud-based bucket solution such as AWS S3, GCP, or similar solution that allows for easy transfer of large video files.
Error posting to Instagram: No error
I've noticed a recent glitch with Instagram API that sometimes returns "No Error" and video rejected, but this looks like an issue on IG side, as I haven't changed anything on the Blotato side. I'll keep monitoring it, but I generally recommend the following:
reduce the number of hashtags
reducing the length of caption
increasing time between posts
Could not publish on Instagram: Error validating access token: Sessions for the user are not allowed because the user is not a confirmed user
This error comes from Instagram/Meta. The Instagram account session is not confirmed. To fix: 1) Log into the Instagram account in a browser and complete any pending prompts (email/phone confirmation, security checkpoints, updated terms). 2) Reconnect the account in Blotato: go to Settings > Social Accounts, disconnect and reconnect using an incognito browser logged into only that Instagram account. 3) Verify the account is a Professional or Business account (personal accounts have issues with third-party publishing). See: https://help.blotato.com/settings/social-accounts/instagram
Source / Ingestion Errors
TikTok video has no captions / transcript extraction failed
Blotato extracts the transcript from TikTok videos to use as a source. If the TikTok video has no captions (subtitles), Blotato cannot pull the transcript. Try a different TikTok video that has captions, or copy-paste the video's content as a Text source instead.
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.
invalid_grant (Instagram/Meta)
The Instagram/Meta authorization token expired. Go to Settings > Social Accounts, find the Instagram account, and click Reconnect. This error often causes follow-on "mediaUrl" TypeErrors -- fix the token first.
Platform-Specific Errors
Post failed to publish. Could not upload video
Each platform has different requirements for video uploads. Check that your video follows the requirements here: https://help.blotato.com/api/media
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.
You have reached the maximum number of 10 posts for the last 24 hours for this account (YouTube)
YouTube enforces a limit of 10 uploads per channel per 24 hours via API. Wait 24 hours and try again, or upload directly via the YouTube website. This is a YouTube limit, not a Blotato limit.
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.
Sorry! This site doesn't allow you to save Pins.
This error is from Pinterest. Two common causes: 1) The website indicated they do not want to be pinned. 2) Pinterest's blocklist flagged your URL (often a false positive). Workaround: append parameters to your link (e.g., ?ref=pin&v=111) so Pinterest sees it as a new URL that bypasses the filter.
Pinterest API access is temporarily restricted to verified accounts only
Submit a support ticket to get verified for Pinterest. Your Pinterest account must be manually warmed up for 1-2 weeks before connecting to 3rd party apps like Blotato. Post 1 pin per day manually, then gradually ramp up to 2, then 3 pins per day, then submit your support ticket.
Error posting to Instagram: We restrict certain activity to protect our community.
Instagram made a final decision based on risk/spam scores. To fix: 1) Reduce the number of hashtags. 2) Reduce your caption length. 3) Increase time between posts. 4) If none of the above works, try posting manually to warm up your account and prove to Instagram you're not a bot.
Cannot read properties of undefined (reading 'mediaUrl')
This Instagram-specific error has multiple causes: 1) Expired Instagram token -- check for invalid_grant errors in your API Dashboard and reconnect the account in Settings. 2) The content.mediaUrls array is empty or contains URLs that are not publicly accessible. 3) In n8n/Make workflows, the node upstream of the Publish node is not outputting a media URL -- verify the Create Visual step completed with status "done". Fix the token first, as expired tokens cause this error most frequently.
Could not publish on Instagram: Unsupported post type. The post has too little or too many attachments to qualify as a carousel
Via API, Instagram supports a maximum of 10 images or videos per carousel. See: https://help.blotato.com/api/media#carousel-specifications
This user is not allowed to post a video longer than 2 minutes (X/Twitter 403 Forbidden)
X/Twitter limits video length based on account type. Free accounts are limited to 2-minute videos. To post longer videos, upgrade to X Premium.
You are not permitted to perform this action (X/Twitter 403 Forbidden)
Twitter/X authorization expired or permissions changed. Go to Settings > Social Accounts, find your Twitter account, and click Reconnect. Re-authorize the app when prompted. Retry your post after reconnecting.
You are not allowed to create a Tweet with duplicate content (X/Twitter 403 Forbidden)
X/Twitter rejects posts with identical text to a previous tweet on your account. Change the caption text (even slightly) before reposting. If you scheduled the same post twice by accident, delete the duplicate from Upcoming Posts.
Post published twice / duplicate post
A timeout during publishing caused Blotato to retry, resulting in two posts on the social platform. Delete the duplicate from the social platform. If this happens repeatedly, submit a support ticket with the post URLs and timestamps.
Bluesky posts publish without images (API)
Known bug affecting image attachments to Bluesky posts via API. The post publishes but images are missing. Contact support via in-app chat for status updates.
Unsupported picture size (TikTok)
TikTok rejected the image. Ensure the image is in JPEG or WebP format (not PNG), under 20 MB, and max 1080 pixels resolution. See: Social Platform Requirements
The parent job ... cannot be replaced. addJob
This error comes from the internal media conversion queue when multiple publish attempts try to use the same job ID instead of creating a new one. Common causes: 1) Your automation runs parallel publish attempts for the same post, 2) WAIT time too short - previous conversion still in progress, 3) Publishing before mediaURL/asset is ready. Fix: In n8n/Make automations, ensure only one publish attempt runs at a time and wait for mediaURL to be ready before publishing. Check API Dashboard for the exact failed request details.
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. Contact Sabrina via in-app chat in the bottom right corner for validation.
5 posts per day recommended, 35 max
Posting above 5 per day negatively impacts post reach. This is a Facebook limitation.
YouTube
10 uploads per channel per 24h via API
YouTube-enforced limit. New channels may have lower quotas. Upload via YouTube website to bypass.
For full details on platform posting limits, see: https://help.blotato.com/settings/social-accounts#platform-posting-limits
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 your API Dashboard - click on any request to see the full payload, error response, and which account it was sent to
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