> For the complete documentation index, see [llms.txt](https://help.contouron.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.contouron.com/platforms/tiktok/faqs.md).

# FAQs

> For the complete documentation index, see [llms.txt](https://help.contouron.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.contouron.com/platforms/tiktok/faqs.md).

## FAQs

### Is Your Tiktok Account Healthy or Shadowbanned?

* If your views are consistently < 50:

Something's wrong with your account. If you have 10 videos in a row, all <50 views, it's likely your account is shadowbanned. I honestly recommend starting fresh with a new account.

* If your views are consistently \~200:

Nothing's wrong with your account. But Tiktok doesn't know the TOPIC of your videos. Click on a video, check top search bar, it should NOT say "Find Related Content".

Be more explicit using niche keywords (such as "AI") in your video title, description, and audio. Once you fix this, your views should be consistently >1000.

* If a SINGLE video is stuck at low views but rest of your account is fine:

Change that video's privacy setting to PRIVATE, close TikTok app, reopen tiktok app, switch privacy setting back to EVERYONE.

This happens to me often with a new Tiktok account. With an older legit account, it can still happen especially if your video uses controversial terms (e.g. politics, money).

***

### Why Does the Pricing Page Say 900 TikTok Posts/Month, but I Hit a Limit on Starter?

Both numbers are correct. The "900 TikTok posts/month" figure on the pricing page is the math result of the Starter-plan TikTok posting limit:

* 3 unique TikTok accounts per 24 hours
* 10 posts per account per 24 hours
* 3 × 10 = 30 posts per day
* 30 × 30 = **900 posts per month**

There is no monthly counter. The limit is enforced **per day**, not per month. If you try to post to a 4th unique TikTok account in the same 24-hour window, the post fails.

**This limit applies to the Starter plan only.** Creator and Agency plans are unrestricted on the 3-unique-accounts-per-24h cap.

If you need to post daily to 10–20 TikTok accounts, you need the Creator or Agency plan.

The "20 social accounts" figure on the pricing page is the **connection** limit (how many accounts you link to Contouron), which is separate from the 24-hour **posting** limit.

Full breakdown: Platform Posting Limits

***

### How Do I Access TikTok Drafts Published via Contouron?

When you publish a TikTok post as a draft (using the `isDraft` option), follow these steps to access it:

1. Open the TikTok mobile app on your phone
2. Go to your system notifications (the inbox icon)
3. Look for a notification from TikTok about your draft
4. Tap the notification to open and finalize your draft
5. Make any edits and publish directly from the TikTok app

Note: TikTok drafts sent via third-party apps like Contouron appear in your notifications, not in the standard Drafts folder in your profile.

Captions are not carried over when publishing as a draft. This is a TikTok API limitation. After the draft is created, open the TikTok app and re-enter your caption before publishing the draft.

#### TikTok Draft Posts Stuck in "Processing"

When publishing TikTok drafts via the API (`isDraft: true`), drafts sometimes stay in "processing" status and never complete.

Common causes:

1. TikTok flagged your account for spam risk -- posting too frequently or posting similar content triggers TikTok's automated review
2. The video file format does not meet TikTok's requirements -- TikTok silently rejects some formats during draft processing
3. TikTok's servers are experiencing delays

Steps to resolve:

1. Reduce posting frequency to 1-2 posts per day for a week
2. Post 1-2 videos manually from the TikTok app (not via API) to re-establish account trust
3. Avoid posting duplicate or near-duplicate content
4. After 1 week of manual activity, retry API publishing with `isDraft: false` first to test, then switch back to `isDraft: true` once direct publishing works

If regular (non-draft) API posts publish fine but drafts fail, this is a known TikTok API limitation with draft processing. Use direct publishing (`isDraft: false`) as a workaround.

***

### How Do I Set a Custom Thumbnail for TikTok?

You can set a custom thumbnail/cover for TikTok slideshows and TikTok reels.

**For TikTok slideshows:**

Set the index of the slide to use as the cover.

**For TikTok reels:**

Set the millisecond timestamp to use as the cover in the "Video cover timestamp (milliseconds)" field.

<figure><img src="/files/94X5TJRTXUnBH7qiikJo" alt=""><figcaption></figcaption></figure>

***

### Why Did Tiktok Ban My Account?

It's very important for Tiktok accounts to make sure they're warmed up: <https://help.contouron.com/platforms/tiktok/brand-new-accounts>

After your account is warmed up, then you can connect a 3rd party app like Contouron to post on tiktok. But generally, it's not recommended to post more than 3x/day via any 3rd party app. Also, make sure you are still using your Tiktok account like a person, logging in, replying to comments, etc. Tiktok bans accounts it thinks are bots - just posting, not engaging.

***

### TikTok Token Refresh Failure ("Service Unavailable")

If you see "Could not refresh TikTok access\_token: Service Unavailable," TikTok's servers temporarily rejected the connection refresh.

1. Wait 15-30 minutes
2. Retry the post from [Failed Posts](https://my.contouron.com/failed)
3. If the error continues, reconnect your TikTok account in [Settings](https://my.contouron.com/settings)

***

### TikTok Connection Stuck on "Maximum Amount of Attempts Reached, Please Try Again Later"

This message means TikTok blocked the OAuth connection flow for that account on their side. Waiting does not always clear it, even after 48 hours. The usual cause is TikTok's OAuth account picker getting confused when several TikTok accounts are logged in at once. Removing and re-adding the account uses more attempts and keeps the loop going, so try this order instead:

1. Log out of ALL TikTok sessions in your browser. Go to tiktok.com, click your avatar, and select Log out. Repeat until every account is logged out.
2. Open an incognito or private window. Sign into ONLY the account you want to connect on tiktok.com. Then, in the same window, go to [Settings > Social Accounts](https://my.contouron.com/settings) and click Login with TikTok. This isolates the OAuth to that one account.
3. Clear cookies for tiktok.com (padlock icon > Site settings > Clear data), then repeat step 2.
4. Try a different browser you do not normally use for TikTok, such as Edge, Firefox, or Safari.
5. Check the TikTok mobile app for a pending security prompt on that account. Finish any email, phone, or unusual-activity verification. A pending prompt blocks OAuth.

If the connection still fails after these steps, message support in the in-app chat with the account name so the team can investigate.

***

### "Failed to Publish TikTok Post After 3 Retries: Unknown Error Reason"

This is a temporary TikTok-side outage, not a Contouron issue, and it is not caused by running out of credits. The failure happens on TikTok's servers, and other publishing tools hit the same errors during these outages. When several recent TikTok posts fail this way at once, it is a TikTok outage and retrying right away or reconnecting your account usually will not help. A public status page will not always show it (some outages affect only certain regions or posts published from external URLs).

1. Wait a few hours for TikTok to resolve the issue, then retry your post from [Failed Posts](https://my.contouron.com/failed)
2. Message support in the in-app chat -- the team can confirm whether there is a known TikTok outage and add +3000 credits for the inconvenience

***

### My TikTok Post Disappears and Never Shows Up (Stuck "Buffering," Not in Failed Posts)

Your TikTok post leaves Upcoming Posts at its scheduled time, then never appears on TikTok, in Published Posts, or in Failed Posts, and there is no matching request in your [API Dashboard](https://my.contouron.com/api-dashboard). The post stays "buffering" or stuck in a "publishing" state. Your other platforms publish the same content fine, and manual posts from the TikTok app work.

This is a TikTok-side issue processing videos from external URLs, which leaves the post stuck in "publishing" so TikTok never returns a success or failure. Because no final response comes back, the post does not land in Failed Posts. It is not a credits issue and not a Contouron queue problem. These outages sometimes affect only certain regions (for example, European accounts) even while the rest of TikTok works.

1. Wait a few hours, then post the same video again with a longer lead time (avoid scheduling only 1-2 minutes ahead)
2. Confirm the post is not in [Failed Posts](https://my.contouron.com/failed) -- retrying a post that never failed will not help while the outage is active
3. Message support in the in-app chat with the account name and scheduled time -- the team can confirm a known TikTok outage and add credits for the inconvenience

***

### My TikTok Post Fails With a Message Saying I Need to Update TikTok

Some TikTok publish failures return a message telling you to update your TikTok app. This happens even when your phone says the app is up to date. The fix runs on the phone connected to the TikTok account:

1. Open the App Store (iOS) or Google Play (Android) and update the TikTok app to the latest version
2. Open TikTok once, log in, force close the app, then reopen it
3. Retry the publish from Contouron ([Failed Posts](https://my.contouron.com/failed))
4. If it still fails after updating, go to [Settings > Social Accounts](https://my.contouron.com/settings), click Reconnect next to TikTok to refresh the token, then retry

Do not disconnect the account. Reconnect refreshes the token without failing your scheduled posts.

***

**Didn't find your answer?**

* General FAQs
* [API FAQs](https://github.com/Contouron-Inc/help.contouron.com/tree/main/api/faqs.md)
* Video FAQs


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.contouron.com/platforms/tiktok/faqs.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
