# TikTok API guide

> Create TikTok video and photo posts for the creator to review in Postprism, or send them straight to the creator’s TikTok inbox as drafts. Platform key: tiktok.

**Source:** https://postprism.app/docs/platforms/tiktok  
**Updated:** 2026-10-10

---

|   |   |
| --- | --- |
| Platform key | `tiktok` |
| Text limit | 4,000 characters (caption) |
| Media | Required. One video, or a photo post of up to 35 images. |

## Things to know

- TikTok asks creators to review every post before it goes to their profile. A TikTok post created or changed through the API or MCP is saved as a draft, and the response includes a `notice`. The creator opens it in Postprism, chooses who can see it and schedules it.
- With `"postMode": "MEDIA_UPLOAD"` no review is needed: the post goes to the creator’s TikTok inbox at the scheduled time, and they finish and post it in the TikTok app. TikTok allows 5 pending drafts per creator in 24 hours.
- It can take a few minutes for a post to process and appear on the profile.

## Settings

Optional TikTok options go in `platform_content.tiktok.settings`. Invalid values are rejected when you create or update the post, with a message naming the field.

| Field | Type | Description |
| --- | --- | --- |
| `postMode` | `"MEDIA_UPLOAD"` | Send the post to the creator’s TikTok inbox as a draft instead of waiting for review in Postprism. |

**platform_content.tiktok**

```
"tiktok": {
  "content": "How we pull a shot of espresso in 25 seconds #coffee",
  "settings": { "postMode": "MEDIA_UPLOAD" }
}
```

## Example

**POST /api/v1/posts**

```
{
  "base_content": "Our autumn menu is here.",
  "platforms": ["tiktok"],
  "platform_content": {
    "tiktok": {
      "content": "Our autumn menu is here. Which drink first?"
    }
  },
  "scheduled_at": "2026-10-16T09:30:00Z"
}
```

Other platforms: [LinkedIn](https://postprism.app/docs/platforms/linkedin), [X (Twitter)](https://postprism.app/docs/platforms/twitter), [YouTube](https://postprism.app/docs/platforms/youtube), [Pinterest](https://postprism.app/docs/platforms/pinterest), [Bluesky](https://postprism.app/docs/platforms/bluesky). Writing limits for every network are in our [character limit](https://postprism.app/glossary/character-limit) reference, and the [TikTok scheduler](https://postprism.app/platforms/tiktok-scheduler) page covers scheduling from the app.
