Upload Video to TikTok

Action ID: tiktok_upload_video

Description

Upload a video to TikTok

Connection

Name	Description	Required	Category
TikTok Connection	The TikTok connection to use to call the TikTok API.	True	tiktok

Input Parameters

Name	Type	Required	Default	Description
video_url	string	✓	-	The URL to the video to upload. Must be a publicly accessible video file.

View JSON Schema

{
  "description": "Input for Tiktok Upload Video node.",
  "properties": {
    "video_url": {
      "description": "The URL to the video to upload.",
      "title": "Video URL",
      "type": "string"
    }
  },
  "required": [
    "video_url"
  ],
  "title": "TiktokUploadVideoNodeInput",
  "type": "object"
}

Output Parameters

Name	Type	Description
publish_id	string	The publish ID of the TikTok video.

View JSON Schema

{
  "description": "Node output for Tiktok Upload Video node.",
  "properties": {
    "publish_id": {
      "description": "The publish ID of the Tiktok video.",
      "title": "Publish ID",
      "type": "string"
    }
  },
  "required": [
    "publish_id"
  ],
  "title": "TiktokUploadVideoNodeOutput",
  "type": "object"
}

How It Works

This node downloads the video from the provided URL, validates it meets TikTok's requirements, and uploads it to TikTok using the TikTok API. The video is processed and published to the connected TikTok account. Upon successful upload, TikTok returns a publish_id that can be used to track the video's status and retrieve additional information about the published content.

Usage Examples

Example 1: Upload Marketing Video

Input:

video_url: "https://storage.example.com/videos/product_launch_2024.mp4"

Output:

publish_id: "v2.public.MTIzNDU2Nzg5MA%3D%3D"

Example 2: Upload Generated Content

Input:

video_url: "https://cdn.agenticflow.com/generated/promo_video_abc123.mp4"

Output:

publish_id: "v2.public.OTg3NjU0MzIxMA%3D%3D"

Example 3: Upload User-Generated Content

Input:

video_url: "https://ugc-platform.com/uploads/user_12345/video_789.mp4"

Output:

publish_id: "v2.public.NDU2Nzg5MDEyMw%3D%3D"

Common Use Cases

• Automated Content Publishing: Schedule and automate video uploads to TikTok as part of content marketing workflows

• Cross-Platform Distribution: Simultaneously publish content to TikTok and other social media platforms

• Bulk Video Upload: Upload multiple videos in sequence for content campaigns

• Generated Content Publishing: Upload AI-generated or edited videos to TikTok

• User Content Moderation: Review and approve user-generated content before uploading to brand accounts

• Marketing Campaigns: Automate video publication for time-sensitive marketing campaigns

• Content Repurposing: Upload reformatted content from other platforms to TikTok

Error Handling

Error Type	Cause	Solution
Authentication Error	Invalid or expired TikTok connection	Re-authenticate your TikTok connection with valid credentials
Invalid Video URL	URL is malformed or inaccessible	Verify the URL is correct and publicly accessible
Video Format Error	Video format not supported by TikTok	Convert video to MP4 format with H.264 codec
Video Too Large	Video exceeds TikTok's size limits	Compress video or reduce resolution to meet size requirements
Video Too Short/Long	Video duration outside TikTok's limits	Ensure video is between 3 seconds and 10 minutes
Download Failed	Cannot download video from URL	Check URL accessibility and network connectivity
Rate Limit Exceeded	Too many uploads in short period	Wait before uploading more videos or upgrade API limits
Account Restricted	TikTok account has upload restrictions	Check account status and resolve any TikTok policy violations

Notes

• Video Requirements: TikTok accepts MP4 and MOV formats. Recommended resolution is 1080x1920 (9:16 aspect ratio) for optimal mobile viewing.

• File Size Limits: Maximum file size is typically 287.6 MB for iOS and 72 MB for Android. Check current TikTok limits.

• Duration Limits: Videos must be between 3 seconds and 10 minutes in length (may vary based on account type).

• Authentication: Ensure your TikTok connection is properly configured and has necessary permissions for video uploads.

• Publishing Status: Use the publish_id to track upload status and retrieve video details through TikTok's API.

• Content Guidelines: Ensure videos comply with TikTok's community guidelines to avoid removal or account penalties.

• Async Processing: Video processing on TikTok may take time. The video might not be immediately visible after receiving the publish_id.

• API Limits: Be aware of TikTok's API rate limits for uploads. Implement appropriate delays between uploads if processing multiple videos.