Skip to content

TikTok Setup

Configure TikTok integration through the TikTok for Developers portal.

Prerequisites

  • TikTok Developer Account
  • Business account (for Content Posting API)
  • Approved app (sandbox available for testing)

Required Scopes

Content Posting

ScopePurpose
user.info.basicGet basic user info
user.info.profileGet profile info (avatar, display name)
video.uploadUpload videos to TikTok
video.publishPublish uploaded videos

Analytics (Optional)

ScopePurpose
video.listList user's videos

Platform Limitations

WARNING

TikTok has significant API limitations compared to other platforms.

FeatureStatus
Video posting✅ Supported
Image/carousel posting❌ Not supported via API
Stories❌ Not supported via API
Drafts✅ Supported (publish later)
Comments/inbox❌ Not available via public API

Video Requirements

  • Duration: 3 seconds to 10 minutes
  • File size: Up to 4GB
  • Format: MP4, WebM recommended
  • Resolution: 720p minimum recommended

Callback URL

https://api.tendsocial.com/api/social/accounts/callback/tiktok_business

Set this in: TikTok Developer Portal → Your App → Configuration → Redirect URI

Environment Variables

bash
TIKTOK_CLIENT_KEY=your_client_key
TIKTOK_CLIENT_SECRET=your_client_secret

Sandbox vs Production

TikTok provides a sandbox environment for testing:

EnvironmentUsersRate LimitsFeatures
SandboxTest users onlyLower limitsFull API access
ProductionAll usersProduction limitsRequires app review

To move to production, submit your app for review in the TikTok Developer Portal.

Upload Flow

TikTok uses a multi-step upload process:

  1. Initialize upload → Get upload_url
  2. Upload video chunks → POST to upload_url
  3. Publish video → Create post with uploaded video

This is handled automatically by TendSocial's publishing system.

TendSocial Documentation