How to Auto-Post TikTok Videos via API

Step-by-step

1. 1

   Connect TikTok inside a CodivUpload profile

   Open Dashboard → Profiles, create or pick the profile that represents the TikTok account, then click Connect → TikTok. Approve the scopes when TikTok prompts: video.upload, video.publish, and user.info.basic. CodivUpload stores the encrypted OAuth tokens and refreshes them automatically — you'll never need to handle TikTok's 24-hour token rotation.

2. 2

   Generate an API key

   Dashboard → API Keys → Create Key. Use a separate key per environment (production, staging) so you can revoke one without breaking the others. Each key inherits the workspace-level scopes and is rate-limited per-key.

3. 3

   Send a POST /v1/posts request with profile_name + platforms

   Set post_type=video, profile_name to your profile's display name, and platforms=["tiktok"]. The video URL goes into media_urls (single element). Use the description for the visible caption — TikTok parses #hashtags and @mentions inside the description automatically. The title field is shown in the analytics dashboard but not on the public video page.

   curl -X POST https://api.codivupload.com/v1/posts \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "post_type": "video",
       "profile_name": "my_brand",
       "platforms": ["tiktok"],
       "media_urls": ["https://your-cdn.example.com/clip.mp4"],
       "title": "How I automate my workflow",
       "description": "How I automate my workflow ✨ #productivity #automation",
       "tiktok_privacy_level": "PUBLIC_TO_EVERYONE",
       "tiktok_disable_comment": false,
       "tiktok_disable_duet": false,
       "tiktok_disable_stitch": false
     }'

4. 4

   Choose Direct Post or Draft mode

   By default CodivUpload uses TikTok's Direct Post path, which publishes the video immediately (or at scheduled_date). To send the upload to the user's TikTok inbox where they can finalize manually, set tiktok_post_mode=DRAFT. This is the right default for client-approval workflows: the agency uploads via API, the client gets a notification on their phone and posts when ready. The video sits in TikTok's inbox indefinitely until they take action.

5. 5

   Disclose branded content correctly

   If the video is a paid promotion or sponsored content, TikTok requires you to set the brand-content toggle. Pass tiktok_brand_content_toggle=true to mark it as a paid partnership (the third-party advertiser case) or tiktok_brand_organic_toggle=true to mark it as your own brand promoting itself. Failing to disclose paid content can result in account-level penalties from TikTok's enforcement team.

6. 6

   Schedule for later

   Add scheduled_date in ISO 8601 UTC format and CodivUpload's queue picks it up at that exact moment. Or use schedule_best_time=true to let CodivUpload pick the optimal time based on your last 90 days of TikTok analytics. The two options are mutually exclusive — passing both returns a 400 validation error.

Frequently asked