TikTok API and MCP

Build a TikTok publish request with media, privacy, interaction, and disclosure fields.

TikTok requires media, a privacy setting, and 6 boolean declarations. Set these from the user's intended privacy, interaction, brand, and AI-content choices. The example uses SELF_ONLY.

Fields

Field	Use
privacyLevel	Required: SELF_ONLY, PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, or FOLLOWER_OF_CREATOR.
disabledComments, disabledDuet, disabledStitch	Required booleans for interaction settings.
isBrandedContent, isYourBrand, isAiGenerated	Required booleans describing the content.
title	Optional image-post title.
autoAddMusic	Optional music setting for image posts.
isDraft	Optional draft submission instead of direct publication.
imageCoverIndex, videoCoverTimestamp	Optional cover selection. Read the schema for units and valid values.

For MCP, pass platform-specific fields alongside accountId, platform, text, and mediaUrls. For REST, platform-specific target fields belong inside post.target. Thread content belongs inside post.content.additionalPosts.

Media and formats

Use one video or an image post. Do not put multiple videos in one post. Check media dimensions and conversion requirements before publishing.

Read TikTok media requirements and upload and conversion rules. Public media URLs go directly in mediaUrls. No upload step required.

MCP example

Call blotato_create_post with the following shape. Replace lookup IDs and example media URLs with returned IDs and your media. Adjust the example's settings to the user's request.

{
  "accountId": "ACCOUNT_ID_FROM_LOOKUP",
  "platform": "tiktok",
  "text": "A caption for your TikTok video.",
  "mediaUrls": [
    "https://example.com/video.mp4"
  ],
  "privacyLevel": "SELF_ONLY",
  "disabledComments": false,
  "disabledDuet": false,
  "disabledStitch": false,
  "isBrandedContent": false,
  "isYourBrand": false,
  "isAiGenerated": false
}

REST example

Send this JSON to POST https://backend.blotato.com/v2/posts with your blotato-api-key header.

{
  "post": {
    "accountId": "ACCOUNT_ID_FROM_LOOKUP",
    "content": {
      "platform": "tiktok",
      "text": "A caption for your TikTok video.",
      "mediaUrls": [
        "https://example.com/video.mp4"
      ]
    },
    "target": {
      "targetType": "tiktok",
      "privacyLevel": "SELF_ONLY",
      "disabledComments": false,
      "disabledDuet": false,
      "disabledStitch": false,
      "isBrandedContent": false,
      "isYourBrand": false,
      "isAiGenerated": false
    }
  }
}

Verify the result

1. Save the returned postSubmissionId.

2. If processing continues, use blotato_get_post_status or GET /v2/posts/:postSubmissionId.

3. Report the returned status and public URL when supplied.

For scheduling, add scheduledTime or useNextFreeSlot as an MCP argument or a REST top-level sibling of post. See Scheduling and completion rules.

Limits and troubleshooting

Starter permits posting to 3 distinct TikTok accounts during a rolling 24-hour window. This counts posting destinations, rather than connections. A TikTok draft still needs completion in TikTok. Report draft delivery separately from a public post.

See TikTok account guide, platform help, and the Publish Post reference for options and examples.