Skip to main content
Sign in

Troubleshoot TikTok

  • Updated

Table of Content

  1. Why the TikTok post failed?
  2. Link or article failed to publish
  3. How do I connect TikTok to Hookle?
  4. Cannot connect, or connecting multiple TikTok accounts?
  5. Disallowed User-Agent error while connecting TikTok
  6. Why I cannot see TikTok Stats or Posts in Hookle?
  7. ERROR CODE: The user did not authorize the scope
  8. ERROR CODE: The image or video does not meet TikTok's size or format requirements

1. Why the TikTok post failed?

Please check you are online - publishing posts need an internet connection.

Unfortunately, sometimes the connection to your TikTok account expires or is revoked due to the security measures by TikTok. Thus you cannot publish posts anymore. To fix that, please reconnect the account if needed.

The post may also fail if you've posted more than 25 times within a 24-hour period, as this exceeds the daily posting limit.

See also error codes below.

2. Link or article failed to publish

If you share a link or article in Hookle and try to publish it to TikTok, the post might fail with the error "picture_size_check_failed" or equivalent. This usually happens because the preview image from the link doesn’t meet TikTok’s size requirements.

To avoid this, you can manually add a relevant image (e.g. from the article) before publishing and make sure it meets TikTok’s image guidelines. More info of the image guidelines here.

3. How do I connect TikTok to Hookle?

See the instructions here.

4. Cannot connect, or connecting multiple TikTok accounts?

See the instructions under "Connect multiple TikTok to Hookle".

5. Disallowed User-Agent error while connecting TikTok 

LinedIn personal.jpg

For security reasons, TikTok won't let connections if your browser is disabled. If it's disabled, you will get a 'Disallowed User-Agent' error. To fix this, enable the browser on your phone: Settings-> Apps -> Chrome -> Enable.

Note! If you're using Firefox as your browser, please switch to another browser like Chrome to successfully connect to TikTok. There's a known bug in Firefox that's currently preventing TikTok from being connected to Hookle.

6. Why I cannot see TikTok Stats or Posts in Hookle?

Currently, TikTok insights are unavailable for your TikTok posts and within the Stats view.

Contact us in case you still need help.

7. ERROR CODE: The user did not authorize the scope

If you encounter the error code stating "The user did not authorize the scope required for completing this request. Please ask the user to authorize and then retry" it indicates that Hookle has not been granted the necessary permissions to publish posts on your behalf on TikTok. To fix this, please follow these steps:

  1. Disconnect TikTok from Hookle: Start by unlinking TikTok from your Hookle account.
  2. Remove Hookle Access in TikTok: Open the TikTok app and in top right 'Menu' go to 'Settings and Privacy'. Navigate to 'Security' and select 'Manage App Permission'. Find 'Hookle' in the list and click 'Remove Access'.
  3. Reconnect TikTok to Hookle: Open the Hookle app and connect your TikTok account again. During this process, ensure that you grant all the requested permissions to Hookle.

By following these steps, Hookle should have the necessary permissions to publish posts to your TikTok account.

8. ERROR CODE: The image or video does not meet TikTok's size or format requirements

This error (error code: picture_size_check_failed) means one or more of your photos don’t meet TikTok’s size or format requirements.

How to fix:

  • Make sure your image is in JPEG or WebP format. PNG and other formats are not supported.
  • Make sure each photo is under 20 MB and not too high in resolution. Ensure your image resolution does not exceed 1080 × 1920 pixels (recommended for portrait images on TikTok).
  • If uploading from a link, the URL must be publicly accessible.
  • If your post had a link with a preview image, that likely caused the failure. To fix it, remove the preview (click X top right) and upload an image that meets TikTok's size limits.

Still stuck? Try compressing the image or converting to JPEG using free online tools, then try again in Hookle. If you're still unable to fix it, please contact us.

 

Related articles