Skip to main content
POST
Create a TikTok post
This endpoint has platform-specific fields and publishing rules. See the full scheduling guide for a complete walkthrough including media upload, publishing modes, and examples.

TikTok-specific fields

Publishing modes

Example request

Notes

  • TikTok only supports video media. Image uploads are not supported.
  • Auto-publish posts require video media. Drafts can be created without media.
  • Only 1 video can be attached to a TikTok post.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
brand_id
integer

The id of the brand to which the post belongs.

Required range: x >= 0
auto_publish
boolean

Whether the post should be auto published.

status
enum<string>

The current status of the post.

Available options:
AUTOPUBLISHING,
DRAFT,
EXPIRED,
FAILED,
IMPORTED,
MISSING_APPROVALS,
PARTIALLY_FAILED,
POSTED,
SCHEDULED,
SKIPPED,
USERS_NOTIFIED
text
string

The text of the post.

media_ids
integer[]

The list of the media ids attached to the post.

Required range: x >= 0
timestamp
string<date-time> | null

The scheduled date & time for publishing the post.

disable_comment
boolean
default:false

Whether to allow comments on the post

disable_duet
boolean
default:false

Whether to allow others to duet the post

disable_stitch
boolean
default:false

Whether to allow others to stitch with the post

thumbnail_offset
integer | null

Thumbnail offset in milliseconds

Required range: x >= 0
branded_content_type
enum<string> | null

Branded content type of the TikTok post.

Available options:
promoted,
paid_partnership,
null
music_info
object | null

Trending sound data for the TikTok post. Null if no trending sound is selected.

approval_policy
enum<string>

The approval policy of the approval request

Available options:
APPROVAL_REQUIRED,
APPROVAL_NOT_REQUIRED
approval_requests
object[]

The list of approval requests associated with the post.

board_ids
integer[]

The list of the board ids associated with the post.

Required range: x >= 0
callback_socket_id
string
campaign_ids
integer[]

The list of the campaign ids associated with the post.

Required range: x >= 0
content_tag_ids
integer[]

The list of the content tag ids associated with the post.

Required range: x >= 0
creation_source
enum<string>

To identify the user or the application that created the post.

Available options:
RSS_FEED
duplicate_to_brand_ids
integer[]
write-only

The list of duplicate to brand ids.

Maximum array length: 55
Required range: x >= 0
post_group_id
string<uuid>

The id of the post group associated with the post.

sort_index
number

The sorted index for unscheduled posts.

thumbnail_url
string<url> | null

Image URL to be displayed as a thumbnail in the DH user interface.

title
string | null

Response

Unprocessable Entity

code
integer

Error code

errors
object

Errors

message
string

Error message

status
string

Error name