TikTok Upload Guide
Post videos directly to TikTok using the IndReelForge API. Requires a Basic plan or higher — TikTok is not available on the free tier.
Supported Content Types
| Type | Endpoint | Notes |
|---|---|---|
| Video | POST /api/upload | MP4, MOV — up to 10 min |
| Text / link post | POST /api/upload_text | No video required |
Minimum Requirements (TikTok API)
| Requirement | Value |
|---|---|
| Format | MP4 or MOV |
| Resolution | 720p minimum (1080p recommended) |
| Max duration | 10 minutes |
| Max file size | 4 GB |
| Aspect ratio | 9:16 (vertical) recommended; 1:1 and 16:9 also accepted |
Quick Example
curl -X POST https://api.indreelforge.com/api/upload \
-H 'Authorization: Apikey YOUR_KEY' \
-F 'user=my-brand' \
-F 'title=Check out this new drop! #fyp' \
-F 'platform[]=tiktok' \
-F 'video_url=https://your-cdn.com/clip.mp4'
Upload by URL (Recommended)
Pass a public URL via video_url — IndReelForge fetches it server-side:
-F 'video_url=https://your-cdn.com/clip.mp4'
Schedule for Later
-F 'schedule_at=2026-05-01T09:00:00Z'
-F 'timezone=America/New_York'
Or let the queue pick the next optimal slot:
-F 'add_to_queue=true'
TikTok-Specific Fields
| Field | Description |
|---|---|
title | Caption — supports hashtags and mentions |
privacy_level | Required, no default. Who can view the post: one of the privacy_level_options returned by GET /api/profiles/{profile}/tiktok/creator-info (PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, SELF_ONLY). Until the app passes TikTok's audit only SELF_ONLY is offered. |
disable_comment | true to disable comments |
disable_duet | true to disable duets (videos only) |
disable_stitch | true to disable stitches (videos only) |
brand_organic_toggle | true if the post promotes your own brand (labelled "Promotional content") |
brand_content_toggle | true for branded content / paid partnership (labelled "Paid partnership"; can't be SELF_ONLY) |
photo_cover_index | Photo posts: index of the cover image (default 0) |
Uploads to TikTok without privacy_level are rejected with MISSING_PLATFORM_FIELD. By posting you agree to TikTok's Music Usage Confirmation (and, for branded content, the Branded Content Policy).
Photo posts (JPEG or WebP, up to 35 images) are pulled by TikTok from short-lived signed URLs on IndReelForge's verified domain.
Connect TikTok
- Dashboard → Profiles → select your profile
- Click Connect next to TikTok
- Authorise in the TikTok popup
- Return to the dashboard — status shows Connected
Troubleshooting
| Error | Cause | Fix |
|---|---|---|
platform_not_connected | TikTok OAuth not set up | Connect TikTok in profile settings |
plan_required | Free plan | Upgrade to Basic or higher |
video_too_short | Under 3 seconds | TikTok minimum is 3 s |
aspect_ratio_warning | Non-vertical video | Convert to 9:16 for best reach |