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
| Scope | Purpose |
|---|---|
user.info.basic | Get basic user info |
video.upload | Upload videos to TikTok |
video.publish | Publish uploaded videos |
Analytics (Optional)
| Scope | Purpose |
|---|---|
video.list | List user's videos |
Platform Limitations
WARNING
TikTok has significant API limitations compared to other platforms.
| Feature | Status |
|---|---|
| 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
text
https://api.tendsocial.com/api/company/social-accounts/callback/TIKTOK_BUSINESSSet this in: TikTok Developer Portal → Your App → Configuration → Redirect URI
The callback URI must match the redirect URI used in the TikTok authorize URL and token exchange. In production, set OAUTH_REDIRECT_BASE_URL=https://api.tendsocial.com.
Environment Variables
bash
TIKTOK_CLIENT_KEY=your_client_key
TIKTOK_CLIENT_SECRET=your_client_secretSandbox vs Production
TikTok provides a sandbox environment for testing:
| Environment | Users | Rate Limits | Features |
|---|---|---|---|
| Sandbox | Test users only | Lower limits | Full API access |
| Production | All users | Production limits | Requires 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:
- Initialize upload → Get
upload_url - Upload video chunks → POST to
upload_url - Publish video → Create post with uploaded video
This is handled automatically by TendSocial's publishing system.