Skip to content

TikTok Scheduling API

Queue TikTok videos and photo posts for later, each under its own key and limits.

  • Schedule video and photo posts
  • Exact times in ISO 8601
  • Reschedule or cancel until it goes out
  • Same limits, log and webhooks as posting now
post.tsnode
const pk = new Postkey(process.env.POSTKEY_KEY);

await pk.posts.create({
  accounts: [
    "acc_tt_321"
  ],
  content: "Packing 100 orders in under an hour #smallbusiness",
  media: [
    {
      type: "video",
      url: "https://cdn.example.com/packing.mp4"
    }
  ],
  tiktok: {
    format: "video",
    privacy: "PUBLIC_TO_EVERYONE",
    allowComments: true,
    allowDuet: true,
    allowStitch: true
  },
  scheduledFor: "2026-12-01T09:00:00Z"
});
  • TikTokqueued

Queued for Dec 1, 09:00 UTC · key customer_42

Schedule your first TikTok post

  1. 1

    Connect TikTok

    Your customer signs in through TikTok's own login. You get an account ID, never a password.

  2. 2

    Make a key

    Create a key for that customer or agent, scoped to their accounts, with the caps you choose.

  3. 3

    Schedule

    Add scheduledFor to the same request. It goes to TikTok at that time, and a webhook tells you how it went.

Every TikTok format, one endpoint

Pick a format to see the exact request with a publish time and what comes back. Options that only make sense on TikTok sit under "tiktok".

A video post. TikTok processes it before it goes live.

RequestREST
1POST https://api.postkey.dev/v1/posts2Authorization: Bearer pk_cust_42_…3Content-Type: application/json4 5{6  "accounts": [7    "acc_tt_321"8  ],9  "content": "Packing 100 orders in under an hour #smallbusiness",10  "media": [11    {12      "type": "video",13      "url": "https://cdn.example.com/packing.mp4"14    }15  ],16  "tiktok": {17    "format": "video",18    "privacy": "PUBLIC_TO_EVERYONE",19    "allowComments": true,20    "allowDuet": true,21    "allowStitch": true22  },23  "scheduledFor": "2026-12-01T09:00:00Z"24}
Response

202 · scheduled

Queued under customer_42. It goes to TikTok at the time you set.

{
  "id": "post_3k9d2",
  "status": "scheduled",
  "scheduledFor": "2026-12-01T09:00:00Z",
  "results": [
    {
      "account": "acc_tt_321",
      "platform": "tiktok",
      "status": "queued",
      "format": "video"
    }
  ]
}

Everything you need for TikTok scheduling

  • Checked against TikTok's rules

    Before anything is sent, Postkey checks it against TikTok's published limits:

    Video caption
    2,200 characterssource
    Photo post
    Up to 35 imagessource
    Unaudited apps
    Posts are limited to private viewingsource
  • One extra field

    Every TikTok format you can post now can be scheduled with scheduledFor. Nothing else changes.

  • Move or cancel

    Change the time or cancel the post with one call before it goes out.

  • Checked when queued

    Text and media are checked against TikTok's rules when you schedule, so problems show up now.

  • Video and photo posts

    Send one video or a set of images. Set format and the rest of the call stays the same.

  • Privacy the TikTok way

    TikTok wants the creator to choose who sees each post from the options it allows for that account. Postkey returns those options so your UI can show them.

Also for TikTok

PostingTikTok Posting APIPublish TikTok videos and photo posts from your app, with privacy settings handled the way TikTok asks.See the page

Keys & control

Every TikTok post has an owner

Each customer or agent posts to TikTok through its own key: only its accounts, its own caps, its own log, and an off switch that touches nothing else.

Works with your stack

  • Your code

    Node and Python SDKs with the same calls, or plain REST from anything that speaks HTTP.

    • Node
    • Python
    • {}REST
    Read the docs
  • No-code tools

    Call the REST API from an HTTP step in n8n, Make or Zapier. Give each workflow its own key.

    • n8n
    • Make
    • Zapier
    Postkey with n8n
  • AI agents & MCP

    The MCP server lets Claude, Cursor and other agent tools post through their own key, with caps they can't change.

    • MCP server
    About the MCP server

TikTok scheduling questions

Something not here? Email hello@postkey.dev.

What can I post to TikTok?

Videos and photo posts. Both go through the same endpoint with a different format value.

Why do I need to show privacy options?

TikTok's sharing guidelines ask apps to let the creator choose who can see each post, from the choices TikTok allows for that account. Postkey gives you that list per account.

Why would a TikTok post end up private?

TikTok keeps posts from apps that haven't passed its audit private. A public post also needs the creator's privacy choice to allow it.

Why does the response say 'processing'?

TikTok processes uploads before they go live. The call returns right away and a webhook follows with the result.

Can I send the same video to Reels and Shorts too?

Yes. Add the Instagram and YouTube account IDs to the same request. Each platform gets its own result.

How do I schedule a TikTok post?

Send the normal post request with scheduledFor in ISO 8601 (UTC or with an offset). You can cancel or move it until it goes out.

Schedule to TikTok with a key per customer.

Get a key, connect an account, send the request above.