Skip to content

TikTok Posting API

Publish TikTok videos and photo posts from your app, with privacy settings handled the way TikTok asks.

  • Video and photo posts
  • Privacy, comments, Duet and Stitch settings per post
  • Creators connect through TikTok's login
  • A webhook when TikTok finishes processing
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
  }
});
  • TikTokprocessing

TikTok is processing it · webhook on finish

Your first TikTok post in three steps

  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

    Post

    Send the post to /v1/posts with that key. The TikTok result comes back in the response and by webhook.

Every TikTok format, one endpoint

Pick a format to see the exact request 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}
Response

202 · processing

TikTok processes this first. The final result arrives by webhook.

{
  "id": "post_3k9d2",
  "status": "processing",
  "results": [
    {
      "account": "acc_tt_321",
      "platform": "tiktok",
      "status": "processing",
      "format": "video"
    }
  ]
}

Everything you need for TikTok posting

  • 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
  • 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.

  • Interaction settings

    Turn comments, Duet and Stitch on or off per post, using the settings TikTok exposes.

  • Processing tracked

    TikTok processes uploads before publishing. You get a webhook when the post is up, or the reason it isn't.

  • No domain setup

    TikTok pulls photo posts from a verified domain. Upload to Postkey and it serves the files, so you don't verify your own.

Also for TikTok

SchedulingTikTok Scheduling APIQueue TikTok videos and photo posts for later, each under its own key and limits.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 posting 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.

Can I schedule TikTok posts instead?

Yes. Add scheduledFor to the same request. See the TikTok Scheduling API page for details.

Post to TikTok with a key per customer.

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