Tiktok: Video Upload Error: “FAILED: video_pull_failed”

⚠️ Error: FAILED: video_pull_failed

This error means that TikTok couldn’t retrieve or upload the video file from your Stackposts server during the publishing process.
It’s not a permission issue — it’s usually related to the video file, format, or connection.

🔍 Common Causes

1. Video size too large

   • TikTok only allows up to 1 GB per video (sometimes less for normal accounts).

   • Large 4K videos often fail to upload.

2. Unsupported format or encoding

   • Only MP4 (H.264) or MOV are accepted.

   • Avoid formats such as .avi, .mkv, or videos using unusual codecs.

3. Invalid or expired temporary file link

   • If the file was stored temporarily and the session expired, TikTok can’t “pull” the video.

   • Re-upload the video and publish again.

4. Slow or unstable connection

   • A timeout while TikTok fetches the video from your server will trigger video_pull_failed.

5. TikTok business rules

   • Some Business Accounts have restrictions (e.g., region limits, content moderation).

   • If other videos post fine but one fails, it may be flagged automatically by TikTok.

🛠️ How to Fix

1. Re-encode your video to MP4 (H.264) and keep it under 100 MB–500 MB if possible.

2. Try re-uploading the post again — this refreshes the temporary upload link.

3. Ensure your server or hosting allows direct public access to media files (TikTok must be able to download the file via HTTPS).

4. Check your TikTok App permissions: it must include video.upload scope.

5. If you use a Business Account, confirm it’s verified and allowed to post via API.