TikTok Publishing API Documentation | Kavenio Docs

Kavenio publishes to TikTok through organic TikTok connected accounts. TikTok Ads uses a separate tiktokads connection and is not used for organic posting. Use tiktok as the platform value in post targets. Put TikTok-specific publish settings in the target’s platformSpecificData. Kavenio gives each TikTok upload two options:

Post publishes a video or photo carousel directly to the connected TikTok account.
Draft sends a video or photo carousel to TikTok so the creator can review and finish it there.

Use draft: true for Draft. Omit draft, or set it to false, for Post.

Quick Reference

Capability	Support
Platform key	`tiktok`
Video direct post	One HTTPS video URL
Video draft upload	`draft: true` sends the video to Creator Inbox
Photo carousel direct post	1-35 image URLs
Photo carousel draft upload	`mediaType: "photo"` with `draft: true`
Creator readiness	`POST /v1/accounts/:accountId/tiktok/creator-info`
Post analytics	`GET /v1/analytics` for views, likes, comments, shares when the target has a final video ID
Native edit/unpublish	Not supported by the current TikTok API integration

TikTok publish calls are asynchronous. A successful provider response returns a TikTok publish_id, which Kavenio stores as the target platformPostId. TikTok video analytics require the final TikTok video ID, so targets that still only have the asynchronous publish_id report analytics as unavailable.

Refresh Creator Info

Before direct posting, refresh creator info for the connected TikTok account. This updates allowed privacy levels and creator readiness metadata.

curl -X POST "$KAVENIO_API_BASE_URL/v1/accounts/acc_123/tiktok/creator-info" \
  -H "Authorization: Bearer $KAVENIO_API_KEY"

await kavenio.accounts.refreshTikTokCreatorInfo("acc_123");

Use one of the returned privacy levels as platformSpecificData.privacyLevel. TikTok privacy options are account-specific.

Option 1: Post A Video

{
  "profileId": "customer_user_123",
  "content": "Fallback caption if description is omitted.",
  "mediaItems": [
    {
      "type": "video",
      "url": "https://cdn.example.com/launch.mp4",
      "mimeType": "video/mp4"
    }
  ],
  "platforms": [
    {
      "platform": "tiktok",
      "accountId": "acc_123",
      "platformSpecificData": {
        "privacyLevel": "PUBLIC_TO_EVERYONE",
        "allowComment": true,
        "allowDuet": false,
        "allowStitch": true,
        "videoCoverTimestampMs": 1000,
        "videoMadeWithAi": false,
        "description": "TikTok launch caption",
        "commercialContentType": "none",
        "contentPreviewConfirmed": true,
        "expressConsentGiven": true
      }
    }
  ],
  "publishNow": true
}

kavenio posts create \
  --profile-id customer_user_123 \
  --content "Fallback caption if description is omitted." \
  --publish-now \
  --media-url https://cdn.example.com/launch.mp4 \
  --platform tiktok:acc_123 \
  --privacy-level PUBLIC_TO_EVERYONE \
  --allow-comment true \
  --allow-duet false \
  --allow-stitch true \
  --content-preview-confirmed \
  --express-consent-given

Direct video posts require:

exactly one video media item
an HTTPS media URL
privacyLevel
contentPreviewConfirmed: true
expressConsentGiven: true

description overrides the top-level content for the TikTok caption. Video captions can be up to 2,200 characters.

Option 2: Send A Video Draft

Use draft: true to send a video to the creator inbox instead of direct publishing.

{
  "content": "Draft video caption",
  "mediaItems": [
    {
      "type": "video",
      "url": "https://cdn.example.com/draft.mp4",
      "mimeType": "video/mp4"
    }
  ],
  "platforms": [
    {
      "platform": "tiktok",
      "accountId": "acc_123",
      "platformSpecificData": {
        "draft": true
      }
    }
  ],
  "publishNow": true
}

Draft video upload uses TikTok’s Creator Inbox path and returns an async publish_id.

Photo Carousel

Set mediaType: "photo" for TikTok photo carousels.

{
  "content": "Fallback photo description",
  "mediaItems": [
    {
      "type": "image",
      "url": "https://cdn.example.com/photo-1.jpg",
      "mimeType": "image/jpeg"
    },
    {
      "type": "image",
      "url": "https://cdn.example.com/photo-2.webp",
      "mimeType": "image/webp"
    }
  ],
  "platforms": [
    {
      "platform": "tiktok",
      "accountId": "acc_123",
      "platformSpecificData": {
        "mediaType": "photo",
        "privacyLevel": "PUBLIC_TO_EVERYONE",
        "allowComment": true,
        "title": "Photo launch",
        "description": "TikTok photo description",
        "photoCoverIndex": 1,
        "autoAddMusic": true,
        "commercialContentType": "brand_content",
        "contentPreviewConfirmed": true,
        "expressConsentGiven": true
      }
    }
  ],
  "publishNow": true
}

Photo carousel rules:

Field	Rule
`mediaType`	Must be `"photo"`
`mediaItems`	1-35 images
`photoCoverIndex`	Required, zero-based, must reference one included image
`title`	Optional, up to 90 characters
`description`	Optional, up to 4,000 characters
`autoAddMusic`	Photo carousel only

Direct photo posts require privacyLevel, contentPreviewConfirmed, and expressConsentGiven. Draft photo uploads can omit the direct-post confirmation and privacy fields, but still need photoCoverIndex.

Media URLs

TikTok pulls media from your URLs. Kavenio validates obvious unsafe URLs before calling TikTok. Requirements:

URLs must be public and HTTPS.
Private, loopback, and localhost URLs are rejected.
Video posts require exactly one video media item.
Photo posts require image media only.
Photo MIME metadata, when supplied, must start with image/.

Commercial Content And AI Disclosure

Use these fields when relevant:

Field	Behavior
`videoMadeWithAi`	Sends TikTok’s AI-generated content disclosure flag for video posts.
`commercialContentType`	Maps commercial-content disclosure settings.
`allowComment`	Controls comment availability.
`allowDuet`	Video posts only.
`allowStitch`	Video posts only.

Photo posts reject video-only options such as allowDuet, allowStitch, videoCoverTimestampMs, videoCoverImageUrl, and videoMadeWithAi unless the post is a draft upload.

Scheduling

Use Kavenio scheduling fields:

{
  "content": "Scheduled TikTok launch.",
  "scheduledFor": "2027-06-16T10:00:00.000Z",
  "mediaItems": [
    {
      "type": "video",
      "url": "https://cdn.example.com/launch.mp4",
      "mimeType": "video/mp4"
    }
  ],
  "platforms": [
    {
      "platform": "tiktok",
      "accountId": "acc_123",
      "platformSpecificData": {
        "privacyLevel": "PUBLIC_TO_EVERYONE",
        "contentPreviewConfirmed": true,
        "expressConsentGiven": true
      }
    }
  ]
}

Scheduled media URLs must remain publicly reachable until the scheduled publish job runs.

Lifecycle Limitations

TikTok native post-publish edit and unpublish are deliberately unsupported. Kavenio returns PROVIDER_UNSUPPORTED for TikTok lifecycle requests because the current Content Posting API integration does not expose a native edit, delete, or unpublish endpoint for published posts.

Common Errors

Error	Meaning
`TikTok publishing requires exactly one video media item.`	The target is using video mode but does not have exactly one video.
`TikTok video publishing requires an HTTPS media URL.`	TikTok direct video publishing requires HTTPS URL pull.
`TikTok publishing requires platformSpecificData.privacyLevel.`	Direct posts need a creator-allowed privacy level.
`TikTok publishing requires contentPreviewConfirmed=true.`	Set the required TikTok preview confirmation flag.
`TikTok publishing requires expressConsentGiven=true.`	Set the required TikTok consent flag.
`TikTok photo publishing requires 1-35 image media items.`	Photo mode needs at least one image and no more than 35.
`TikTok photo publishing requires platformSpecificData.photoCoverIndex.`	Choose the carousel cover image by index.
`TikTok photoCoverIndex must reference an included media item.`	The cover index is outside the supplied image list.
`Private and localhost media URLs are not allowed.`	Use a public media URL.

​Quick Reference

​Refresh Creator Info

​Option 1: Post A Video

​Option 2: Send A Video Draft

​Photo Carousel

​Media URLs

​Commercial Content And AI Disclosure

​Scheduling

​Lifecycle Limitations

​Common Errors