Skip to main content

Update TikTok Post

PATCH 

/api/tiktok-posting/posts/:tikTokPost

Edits a post in draft, needs_approval, scheduled or failed. Send any subset of the Create TikTok Post fields.

Required scope: tiktok-posts:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Any change clears the approval and the post goes back to needs_approval (a draft stays a draft) — except moving only scheduled_at of a scheduled post, which keeps the approval (the time is not part of what was approved) and still must be at least 5 minutes ahead. Sending publish applies that choice as on create.

Errors: 409 invalid_status when the post can no longer be edited; 422 for validation and account/video problems.

Scope: tiktok-posts:write. Permission: tiktok_posts.create.

Photo posts: send media_type=photo instead of a video:

  • media_type (string, optional, default video): video or photo. Photo posts are only available once SKU.io's photo address is verified with TikTok (see photo_posts_available in List TikTok Accounts by Store); otherwise 422 "Photo posts aren't available yet"
  • video_id: required for video posts; omit or null for photo posts
  • photo_image_ids (integer[], required for photo posts): 1–35 distinct product image IDs, in the order they appear on TikTok. When product_id is set they must be that product's images
  • photo_cover_index (integer, optional, default 0): which photo (0-based position in photo_image_ids) is the cover
  • title (string, optional, photo posts only): up to 90 UTF-16 units
  • caption: for a photo post this is TikTok's description, up to 4000 UTF-16 units
  • allow_duet / allow_stitch are ignored for photo posts (TikTok has no Duet or Stitch for photos) TikTok fetches the photos itself, then the post follows the same statuses as a video. Changing the photos, their order, the cover or the title clears an approval.

Shoppable video (TikTok Shop product link): send these with a video post when the store's TikTok Shop official account is connected (see Get Store Shoppable Video Status):

  • tiktok_shop_product_id (string of digits, optional, max 64): a product from Search TikTok Shop Products for Shoppable Videos. Send null on update to make the post a normal TikTok post again
  • anchor_title (string, required with a product): the text on the product link, up to 30 letters or numbers; punctuation and emoji are removed
  • shoppable_public_confirmed (boolean, required true unless publish=draft): shoppable videos post publicly through TikTok Shop, with no privacy, comment, Duet, Stitch or disclosure settings A shoppable post is always a video posted to the profile (mode direct); privacy_level is not needed. Videos over 10 MB are refused (422 shoppable_video_too_large). Before posting, TikTok Shop checks the video and product link; a failed check fails the post with TikTok Shop's reasons. Changing the product or anchor title clears an approval. The post carries publish_channel (content_posting or shoppable), tiktok_shop_product_id, anchor_title, shop_video_id, shop_precheck_status and shop_precheck_issues.

Request​

Responses​

OK

Response Headers
    Content-Type