TikTok API Error Reference

Solution:

Your access token is no longer valid. Go to account settings and reconnect your TikTok account to get a new valid token. Sign in as the same TikTok account you already have connected: authorizing a different one takes over that connection and deletes its analytics, inbox and DM history.

Solution:

You didn't grant all required permissions. When reconnecting, approve every permission TikTok asks for, including video.publish, video.upload, video.list and user.info.username. A partial grant is refused and changes nothing, so the account keeps working until you retry.

Solution:

Additional permissions are needed for this operation. Reconnect your TikTok account and ensure all permissions are granted.

Solution:

Your TikTok account has been restricted from posting. Log into TikTok directly to see if there are any warnings. You may need to appeal the restriction.

Solution:

Your caption or text was flagged as spam. Avoid repetitive content, excessive links, or promotional language. Try posting different content.

Solution:

TikTok counts a trailing 24 hour window, not a calendar day, so capacity frees up gradually rather than at a fixed reset time. Space the posts out, or post directly in the TikTok app.

Solution:

To reduce spamming, TikTok limits the number of videos that can be uploaded via API that are not pending approval and posting by the creator. There may be at most 5 pending shares within any 24-hour period.

Solution:

TikTok's spam detection system flagged your content. Ensure your content is original and follows TikTok's community guidelines. Avoid repetitive posts.

Solution:

Your video format is not supported. TikTok requires MP4 or WebM format. Convert your video and ensure it meets TikTok's specifications.

Solution:

Video duration must be between 3 seconds and 10 minutes. Trim your video to fit within these limits.

Solution:

TikTok requires a frame rate between 23-60 fps. Re-encode your video with a supported frame rate.

Solution:

Your video resolution is too low. TikTok requires minimum 720p resolution. Use a higher quality video source.

Solution:

Your video is too long. Maximum duration is 10 minutes. Edit your video to be shorter or split it into multiple parts.

Solution:

Maximum file size is typically 287MB for videos. Compress your video or reduce its quality to meet the size limit.

Solution:

TikTok couldn't download your video from the provided URL. Ensure the URL is publicly accessible, returns correct headers, and the file is valid.

Solution:

TikTok couldn't download your image. Verify the URL is publicly accessible and returns the correct content-type header (image/jpeg or image/png).

Solution:

Your file doesn't meet TikTok's requirements. Check that it's a valid video/image file in a supported format and meets all specifications.

Solution:

You've made too many requests too quickly. Wait a few minutes before trying again. The system will automatically retry for you.

Solution:

TikTok is rate limiting your requests. Reduce the frequency of API calls and implement exponential backoff in your retry logic.

Solution:

The app has reached its daily active user limit, which TikTok sets per app. TikTok measures it over a rolling 24 hour window, so capacity frees up gradually over the following hours, not at a fixed reset time. Space out your retries rather than batching them.

Solution:

This is an approval on the app making the call, not on your TikTok account, so there is nothing to change on your side. Contact support if you see it on a Zernio connection.

Solution:

You need to verify ownership of any external URLs in your posts. Add the verification code to your domain or use the TikTok developer console to verify.

Solution:

The privacy level you asked for is not one this account can use. Accounts connected through the TikTok for Business app publish videos as public only, so use PUBLIC_TO_EVERYONE, or draft: true to send the video to TikTok drafts and pick the audience there. Photo posts keep every privacy level.

Solution:

TikTok is experiencing server issues. This is temporary. Wait a few minutes and try again. The system will automatically retry.

Solution:

One or more parameters in your request are invalid. Review the TikTok API documentation and ensure all required fields are present and correctly formatted.