Troubleshooting for Scheduling and Publishing

TikTok Publishing and Upload Troubleshooting Guide

When a TikTok post fails to publish or doesn't behave as expected, it's usually due to one of these reasons: content type configuration, unmet file requirements, or TikTok API limitations. This guide covers the most common causes and how to fix them step by step.

Quick Reference: Problems and Solutions

Problem

Solution

Auto-publish button is disabled

Duplicate the post or use manual publishing

File upload error

Check format, size, and duration requirements

Content type mismatch error

Ensure the selected type matches your file

First comment empty from CSV

Use actual text, not boolean values

Need effects or special music

Use manual publishing

Repeated publishing errors

Reconnect your TikTok account

This guide covers publishing and upload problems. If your video was posted without text or sound, see the specific articles linked at the end of this page.

1. The Auto-Publish Button is Disabled

If you try to enable Auto-publish and the button appears disabled, it's usually because:

  • The scheduled time has already passed and Metricool already sent the manual publishing notification. In this case, auto-publish cannot be re-enabled.

  • The content includes features not supported by the API, such as effects, stickers, or music outside the Top 100 trending songs.

Solution:

  • If the time has passed: duplicate the post from the calendar and enable Auto-publish in the new version.

  • If you need effects or special music: disable Auto-publish and use manual publishing to finish the post in the TikTok app.

2. The Video or Photo Doesn't Meet Requirements

TikTok rejects content that doesn't meet its technical specifications. Check these points:

Video

  • Format: MP4 (recommended) or MOV

  • Size: up to 500 MB

  • Duration: 3 seconds to 10 minutes for auto-publishing

  • Resolution: from 540px

  • Audio: 128kbps recommended

  • Format: JPEG or WebP (PNG is auto-converted)

  • Size: up to 20 MB per image

  • Maximum: 35 images

  • Resolution: up to 1080p

If the file is too large, too short, or in an unsupported format, publishing will fail. Always verify these specifications before scheduling.

3. Error Due to Incorrect Content Type

This is one of the most frequent errors reported to support: the selected publication type doesn't match the file you uploaded.

Symptom: The post fails to publish with a generic error or simply doesn't send.

Cause: Metricool offers different content types (Video, Carousel). If you upload a video but configure it as a carousel, or vice versa, TikTok will reject the publication.

Solution:

  1. Go to the failed post in the calendar.

  2. Check the content type selected.

  3. If it's a single video, make sure it's marked as Video, not Carousel.

  4. If it's multiple photos, select Carousel.

  5. Reschedule the post with the correct type.

When you create a new post, Metricool automatically detects the file type, but if you change it manually or use CSV import, verify that the type matches your content.

4. The First Comment from CSV Doesn't Appear

If you use CSV bulk import to schedule TikToks and the first comment doesn't publish, it's usually due to a formatting error in the file.

Symptom: The post publishes but the first comment is empty or doesn't appear.

Cause: The first comment column contains incorrect values like false, FALSE, 0, or an empty cell. TikTok expects actual text.

Solution:

  1. Open your CSV file.

  2. Locate the first comment column (first_comment or similar).

  3. Ensure each cell contains actual text (the comment you want to publish).

  4. Remove any boolean values like false or TRUE.

  5. Re-upload the CSV and schedule.

Incorrect example:
first_comment
false
FALSE

Correct example:
first_comment
"What do you think? 👇"
"Tell us your experience"

5. TikTok Account Connection Error

If your TikTok posts are failing with repeated errors, the connection between Metricool and TikTok may have expired or the wrong account was connected.

Error 40131: "Refresh token is invalid or expired"

This specific TikTok error means the authorization token Metricool uses to publish on your behalf has expired or was revoked. The old connection can no longer be used—you must reconnect the account.

Solution:

  1. Go to the connections section in Metricool.

  2. Disconnect your TikTok account.

  3. Reconnect the correct account using your TikTok credentials.

  4. If reconnection fails from the browser, try the Metricool mobile app.

This error comes from TikTok's side, not Metricool. Reconnecting establishes a fresh authorization token, which resolves the issue. You don't need to change your video settings or post content—only the account connection.

6. photo_pull_failed Error

This error occurs because the TikTok server failed to download the image and the timeout expired.

Solution:

  • Create a new post (do not duplicate the existing one) and retry.

You can find more details about this error and similar ones in the TikTok API documentation.

7. Post Has a High Spam Risk

This error means that TikTok has detected a high risk of spam-like behavior and rejects the post.

It may be due to:

  • Posting too frequently

  • Other risky actions within the app (such as automations or suspicious patterns)

  • Using multiple accounts to bypass previous restrictions. According to TikTok, creating additional accounts to avoid blocks or restrictions goes against their guidelines.

Solution:

  • Do not retry publishing from Metricool.

  • Check your account status directly in TikTok, and if applicable, submit an appeal from the app.

  • If the account is still allowed to publish, you'll need to reconnect it to Metricool, as access expires for security reasons after this type of alert.

This error comes directly from TikTok's spam detection system. Metricool cannot override it—you must resolve the issue with TikTok first.

8. The Content Requires Manual Publishing

TikTok doesn't allow auto-publishing all content types through its API. You'll need manual publishing if your post includes:

  • Effects, filters, or stickers native to TikTok

  • Music outside the Top 100 trending songs (only business accounts can add Top 100 music)

  • Visible location (the API doesn't support adding location to posts)

  • Duets or Stitches with other videos

For step-by-step instructions on manual publishing, see How to manually publish via notification.

Was this helpful?