How to Set TikTok Video Privacy via API
How TikTok video privacy works when scheduling via the PostFast API. The per-post tiktokPrivacy parameter is deprecated: videos use your account default, and drafts let you publish privately.
Per-post TikTok video privacy is deprecated. TikTok videos now publish with your account's default privacy setting (there is no per-post control), and photos default to public. To keep a post private, schedule it as a draft (tiktokIsDraft: true) and finish publishing from your TikTok inbox. The tiktokPrivacy parameter is still accepted so existing payloads keep working, but it no longer changes video visibility.
TikTok privacy on the PostFast API has changed. Because TikTok's publishing API now applies your account's default privacy setting to videos, the tiktokPrivacy parameter no longer controls who can see a published video, and it is deprecated. It is still accepted so existing integrations keep working, but it does not change video visibility.
To publish something privately, schedule it as a draft with tiktokIsDraft: true and finish publishing from your TikTok inbox, where you can pick the audience. Photo posts default to public. The parameter reference below documents tiktokPrivacy as it stands for backward compatibility.
API Parameters
| Parameter | Type | Description |
|---|---|---|
tiktokPrivacy | string | Controls who can view the video PUBLICMUTUAL_FRIENDSONLY_ME |
Code Example
const response = await fetch('https://api.postfa.st/social-posts', {
method: 'POST',
headers: {
'pf-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
"posts": [
{
"content": "Check out my new video! #tiktok #viral",
"mediaItems": [
{
"key": "video/a7b8c9d1-e2f3-4567-8901-23456789abcd.mp4",
"type": "VIDEO",
"sortOrder": 0,
"coverTimestamp": "3000"
}
],
"scheduledAt": "2025-01-31T10:00:00.000Z",
"socialMediaId": "550e8400-e29b-41d4-a716-446655440001"
}
],
"controls": {
"tiktokPrivacy": "MUTUAL_FRIENDS"
}
})
});
const data = await response.json();
Did You Know?
Tips
To publish privately, set tiktokIsDraft: true and choose the audience when you finish posting from your TikTok inbox
tiktokPrivacy is still accepted, so existing payloads will not error - it is simply ignored for video visibility
You can still set other controls like tiktokAllowComments, tiktokAllowDuet, and tiktokAllowStitch on the post
Ready to automate your TikTok posting workflow?
Common Pitfalls
It no longer does. Video visibility follows your TikTok account default. To publish privately, use tiktokIsDraft: true and set the audience in the TikTok app.
If you still send tiktokPrivacy, the value must be exactly "PUBLIC", "MUTUAL_FRIENDS", or "ONLY_ME" (uppercase) or it is rejected by input validation - even though the value no longer changes video visibility.
Frequently Asked Questions
Can I still control who sees a TikTok video via the API?
No. Video privacy now follows your TikTok account's default setting, and tiktokPrivacy is deprecated - it no longer overrides that. To control the audience, publish the post as a draft (tiktokIsDraft: true) and choose visibility when you finish posting in the TikTok app.
What happens if I still send tiktokPrivacy?
Nothing breaks. The parameter is still accepted for backward compatibility, so existing payloads keep working - the value is simply ignored for video visibility.
How do I publish a private TikTok post?
Schedule it as a draft with tiktokIsDraft: true. PostFast sends it to your TikTok inbox, where you finish publishing and pick the audience (including private). Photo posts otherwise default to public.