Troubleshooting API Errors
To troubleshoot Blotato API errors, check your "Failed" dashboard: https://my.blotato.com/failed
UPLOAD Step - Most Common Errors
Here are the most common reasons the UPLOAD step fails š
1) Wrong Blotato API Key:
check you've copied it correctly without whitespaces
check the blotato-api-key variable is populated correctly in the UPLOAD step
2) URL is empty:
check that the url you're passing in is NOT empty
if the url is empty, this is because your previous step did not finish creating your video/carousel, so you need to increase WAIT time and check you didn't run out of credits
PUBLISH Step - Most Common Errors
Here are the most common reasons the PUBLISH step fails š
1) Wrong Account ID
check you've copied the social account ID correctly
check that accountId variable in PUBLISH step is correctly populated with the value
2) Wrong Page ID
Facebook requires passing in Page ID, along with Account ID
Check you've copied Page ID correctly. There are 2 buttons "Copy Account ID" and "Copy Page ID.
3) Escape Multi-Line Paragraphs
if you have a long text with linebreaks, make sure it is escaped
in n8n, use the function toJsonString() like this:
"text": $("Prepare for Publish").item.json.final_text_long.toJsonString()
4) Invalid File Format
Check that your file format is valid per Blotato API docs
5) Invalid Video Dimensions
As a sanity check, try uploading this video
6) Brand New Account
Follow this playbook to warm up your social media accounts properly, it makes a huge difference: āhttps://help.blotato.com/platforms/tiktok/brand-new-accounts
Don't connect 3rd party apps like Blotato until your account is warmed up. Otherwise, you'll be flagged as a bot.
Error messages like
reached_active_user_cap
are due to new accounts, not properly warmed up.
CREATE FACELESS VIDEO Step - Most Common Errors
Here are the most common reasons the CREATE FACELESS VIDEO step fails š
1) Wrong Blotato API Key:
check you've copied it correctly without whitespaces
check the blotato-api-key variable is populated correctly in the UPLOAD step
2) You Ran Out Of AI Credits:
go to Settings to check if you have enough credits
3) Wrong Template Parameters:
Blotato API offers multiple video templates.
Each template has a different set of parameters, so check what you're passing in.
4) Missing AI Voice
"POV" template doesn't include AI voice because that's not the style of viral POV videos
To get AI voiceover, use the template ID empty
CREATE CAROUSEL/SLIDESHOW Step - Most Common Errors
Here are the most common reasons the CREATE CAROUSEL/SLIDESHOW step fails š
1) Wrong Blotato API Key:
check you've copied it correctly without whitespaces
check the blotato-api-key variable is populated correctly in the UPLOAD step
2) You Ran Out Of AI Credits:
go to Settings to check if you have enough credits
3) Wrong Template Parameters:
Blotato API offers multiple video templates.
Each template has a different set of parameters, so check what you're passing in.
4) Missing Music
You can now add music to Tiktok slideshows. In the PUBLISH TO TIKTOK step, add the parameter autoAddMusic: true (Blotato API docs here)
CREATE HEYGEN AVATAR VIDEO Step - Most Common Errors
Here are the most common reasons the CREATE HEYGEN AVATAR VIDEO step fails š
1) Wrong Heygen API Key and IDs:
check you've copied it correctly without whitespaces
check you've copied the HEYGEN AVATAR ID, not the Heygen Avatar GROUP ID
2) You're On Heygen Free Plan
HeyGen API requires you to pay for its $99/mo API plan. The Free API plan won't work.
3) Your Avatar Has a Background
if you want to use your avatar's default background, NOT a green screen, you'll need to update CREATE AVATAR VIDEO step
set matting to false
remove the section background
4) Increase Wait Time
Avatar videos take awhile to make, so I recommend testing with a short script (1 sentence)
When you increase the length of the script, increase the WAIT time accordingly
How Do I Fix Invalid JSON Error?
How to fix invalid JSON:
1) Check your JSON is valid with this free tool: https://jsonlint.com
2) Copy and paste the following prompt into ChatGPT to compare your JSON with Blotato's API docs: ā
I need help fixing my JSON request to Blotato API.
Here's Blotato API docs: https://help.blotato.com/api-reference ā Here's my JSON request:
<insert_your_json>
API Error: "The service is receiving too many requests from you"
This API error means you are calling the Blotato API too fast.
The Blotato API has a rate limit to prevent spamming and abusing social media endpoints, which helps keep Blotato's integration in good standing with the social platforms.
The Upload Media endpoint has a user-level rate limit of 10 requests per minute.
The Publish Post endpoint has a user-level rate limit of 30 requests per minute.
API Error: "The aspect ratio is not supported"
This API error means the video you're trying to upload is not an aspect ratio supported by the platform.
For example, a video with dimensions 2160x2880 is 3:4. But the only supported Instagram formats are 1:1, 4:5, 1.91:1, 9:16 (as an example).
Seeing error 400 "body/template/id must be equal to constant"?
This error means you need to pass in a template object and id. For example, when generating a video through Blotato API, try this from the examples:
{
"script": "you wake up as a pharaoh",
"style": "cinematic",
"template": {
"id": "base/pov/wake-up"
}
}
I'm making faceless videos via API but GET VIDEO node returns an empty/null mediaURL?
If your GET VIDEO node returns a null or empty mediaUrl
, typically the issue is:
1. Your video is not yet done being created. Increase wait time.
2. You ran out of Blotato AI credits, so the video could not finish.
Seeing error "Error uploading video to Tiktok: Please review our URL ownership verification rules"?
This error means you're trying to post to Tiktok with a URL that Tiktok rejects.
First, upload your media, then use the Blotato URL to post to Tiktok.
Here's a sample Blotato video URL to test it out:
Last updated