You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
When true, sends the post to the TikTok Creator Inbox as a draft instead of publishing immediately. The creator receives an inbox notification to complete posting via TikTok's editing flow. Maps to TikTok API post_mode: "MEDIA_UPLOAD" (photos) or the dedicated inbox endpoint (videos). When false or omitted, publishes directly via post_mode: "DIRECT_POST". Note: publish_type is not a supported field. Use this field instead.
[optional]
privacy_level
String
One of the values returned by the TikTok creator info API for the account
[optional]
allow_comment
Boolean
Allow comments on the post
[optional]
allow_duet
Boolean
Allow duets (required for video posts)
[optional]
allow_stitch
Boolean
Allow stitches (required for video posts)
[optional]
commercial_content_type
String
Type of commercial content disclosure
[optional]
brand_partner_promote
Boolean
Whether the post promotes a brand partner
[optional]
is_brand_organic_post
Boolean
Whether the post is a brand organic post
[optional]
content_preview_confirmed
Boolean
User has confirmed they previewed the content
[optional]
express_consent_given
Boolean
User has given express consent for posting
[optional]
media_type
String
Optional override. Defaults based on provided media items.
[optional]
video_cover_timestamp_ms
Integer
Optional for video posts. Timestamp in milliseconds to select which frame to use as thumbnail (defaults to 1000ms/1 second). Ignored when videoCoverImageUrl is provided.
[optional]
video_cover_image_url
String
Optional for video posts. URL of a custom thumbnail image (JPG, PNG, or WebP, max 20MB). The image is stitched as a single frame at the start of the video and used as the cover. Overrides videoCoverTimestampMs when provided.
[optional]
photo_cover_index
Integer
Optional for photo carousels. Index of image to use as cover, 0-based (defaults to 0/first image).
[optional]
auto_add_music
Boolean
When true, TikTok may add recommended music (photos only)
[optional]
video_made_with_ai
Boolean
Set true to disclose AI-generated content
[optional]
description
String
Optional long-form description for photo posts (max 4000 chars). Recommended when content exceeds 90 chars, as photo titles are auto-truncated.