TIKTOK

TikTok Content Posting API: Publish & Schedule TikTok Videos and Photo Posts

Publish public TikTok videos and photo posts with one API key, without the Direct Post audit, the private-only sandbox or the 24-hour token refresh. Connect an account, then post from your own app, an AI agent or n8n/zapier/make.

Free plan · 2 accounts · No credit card · API + MCP included

SEND FROMYour appAI agentn8n / ZapierPOST /v1/posts · TIKTOK · VIDEO← published · 1,240 viewsWoopSocialAlready auditedValidatePublic accountConvert video1080 × 1920ScheduleFri 18:00Publish to TikToktoken refreshedyour_brandTikTokVIDEO000webhook + analytics

What is the TikTok Content Posting API?

The TikTok Content Posting API is the official TikTok API for publishing your videos and photo posts to your account from another app. There are two modes: Direct post directly publishes the content to your profile, and Upload sends your post to your TikTok inbox to finish it in the app. Public Direct Post is (unlike posting to TikTok through WoopSocial) only accessible for companies that pass TikTok's audit.

WoopSocial has already passed this audit, allowing you to directly post to your profile or schedule posts that go out later. You can also use WoopSocial to publish or schedule posts that are first sent to the inbox of your account(s) on TikTok so you can publish them manually. WoopSocial also handles the media upload, token refreshing, status checks and scheduling.

  • Videos
  • Photo posts
  • Direct post or Inbox draft
  • Custom cover
  • AI-generated label
  • Branded-content disclosure

Using the TikTok Content Posting API directly vs with WoopSocial

Comparison of TikTok Content Posting API direct versus WoopSocial for publishing
TikTok Content Posting API directWoopSocial
Pass the Direct Post audit (2 to 6 weeks) before you can post publiclyAlready audited. Post publicly from day one
Posts stuck at SELF_ONLY, with a cap of 5 users per 24 hours, until the audit passesEvery privacy level available, no user cap
24-hour access tokens to refreshTokens refreshed for you
Query creator info before every post, then poll for status because there are no webhooksOne POST /posts call, plus a signed webhook when the post is published or fails
Strict video encoding requirementsUpload any common format and FFmpeg converts it for TikTok
Required disclosure screens and toggles you have to build yourselfDisclosure fields in the API (isBrandedContent, isAiGeneratedContent and more)

Three steps to automated posting with the TikTok Content Posting API

  1. Step 1

    Connect your account

    Send a hosted connect link to yourself or your own users and they will grant access with a few clicks. You can connect your personal, Creator and Business TikTok accounts and WoopSocial will save and refresh the tokens for you.

  2. Step 2

    Create the post

    Send one request describing the post - TikTok account, type (VIDEO or PHOTO), publish now or draft to creator's inbox, your media, and when to post. For every post. TikTok also asks users to define things like privacy level, comments, duets and stitches and WoopSocial validates these settings before publishing. You can also get a TikTok account's allowed privacy levels and max video length by calling GET /social-accounts/{id}/platform-inputs.

  3. Step 3

    We handle the rest

    WoopSocial posts and converts your media, runs TikTok's asynchronous upload, queries the status, and publishes at the scheduled time. Temporary failures are automatically retried, and a signed webhook informs your app when the post completes or fails.

Everything you need to ship TikTok features

Videos & photo posts

Set postType to VIDEO or PHOTO. The rest of the request stays the same, so adding photo carousels doesn’t mean learning a second endpoint.

Direct post or Inbox draft

Publish live with DIRECT_POST, or send the post to the creator’s TikTok inbox with MEDIA_UPLOAD so they can finish it in the app. This is a pre-made approval flow for agencies.

Compliance built in

Branded content, “your brand” and AI-generated labels are fields on the request, not screens you have to build. Disclosure matters more each year, so your posts stay compliant from the start.

Scheduling & drafts

Schedule to the minute in UTC or draft a post for somebody to review first. WoopSocial creates the draft and queues the post for when you're ready.

Validation

Call /posts/validate to catch a missing TikTok toggle or a bad setting before anything is published, instead of finding out from a rejected post.

Post analytics

Get views, likes, comments and shares back on each video. Read more in our TikTok analytics API guide.

Three ways in

Same TikTok publishing backend whether you talk to an AI agent over MCP, call the REST API, or drop a node into n8n, Zapier or Make.

  1. 1 · Account

    Create a free WoopSocial account

    Sign up at app.woopsocial.com/signup (no credit card). You'll authorize through OAuth when the agent connects — no API key required for MCP.

  2. 2 · TikTok

    Connect a TikTok account

    Personal, Creator and Business TikTok accounts can all connect. Link one in the WoopSocial dashboard before you ask an agent to post.

  3. 3 · Agent

    Add the MCP URL and authorize

    Use https://api.woopsocial.com/mcp. Your client opens OAuth — approve access and you're connected. Docs: Integrating MCP clients.

Install by client

Pick your agent. Cards marked On this site open another WoopSocial page; External opens outside this site (new tab).

Config for Cursor / other MCP clients

Prefer 1-click? Install the WoopSocial Cursor plugin. Or paste this into .cursor/mcp.json (or your client's MCP config). Authorize with OAuth when prompted — no API key in the URL. Allowlist *.cloudflarestorage.com if media uploads are blocked.

json
{
  "mcpServers": {
    "woopsocial": {
      "url": "https://api.woopsocial.com/mcp"
    }
  }
}

Claude Code

One command registers the remote HTTP MCP server. Complete OAuth when prompted.

bash
claude mcp add --transport http woopsocial "https://api.woopsocial.com/mcp"

After install — try this

Plain-language TikTok prompt

You

Post this video to TikTok as public, comments on, labelled AI-generated

Prefer a full walkthrough with screenshots? Start at /social-media-mcp.

REST API example: schedule a TikTok video

Same POST /posts call with a Bearer API key. Authorization header and request body included.

bash
curl -X POST https://api.woopsocial.com/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": [{
      "text": "New video.",
      "media": [{ "type": "MEDIA_LIBRARY", "mediaId": "MEDIA_ID" }]
    }],
    "schedule": { "type": "PUBLISH_NOW" },
    "socialAccounts": [{
      "platform": "TIKTOK",
      "socialAccountId": "YOUR_TIKTOK_ACCOUNT_ID",
      "postType": "VIDEO",
      "postMode": "DIRECT_POST",
      "privacyLevel": "PUBLIC_TO_EVERYONE",
      "allowComment": true,
      "allowDuet": true,
      "allowStitch": true,
      "isAiGeneratedContent": true,
      "isYourBrand": false,
      "isBrandedContent": false,
      "autoAddMusic": false
    }]
  }'

Prefer a calendar? Schedule TikTok videos from the dashboard

Many people don't want to touch an API. If you prefer planning your own content schedule, the WoopSocial dashboard allows you to add TikTok videos to your calendar and upload anytime you want.

Manage multiple TikTok accounts at once for clients or for different owned channels. AI captions help you smash through writer's block, and cross-posting allows you to send the same video to other platforms from the same screen. The dashboard uses the same backend as the API, so a video scheduled by your team in the calendar will work like one your code writes. The free plan includes 2 accounts and doesn't need a card.

Schedule from the dashboard
WoopSocial calendar for scheduling TikTok videos

TikTok requirements & limits

  • Account types

    Personal, Creator and Business TikTok accounts can all connect, so you aren’t limited to one account type when you start posting through WoopSocial.

  • Daily posts

    The limit that TikTok sets for its creators is usually just about 15 posts per creator per day, aggregating all the apps a creator posts on. The exact number can vary by creator.

  • Videos

    MP4, WebM or MOV files up to 4 GB and 10 minutes through the API. Each creator’s own maximum comes back from the platform-inputs endpoint as maxVideoPostDurationSec.

  • Captions

    Video captions can be up to 2,200 characters. Photo posts allow a title of up to 90 characters and a description of up to 4,000 characters.

  • Photo posts

    Up to 35 images per post, in JPEG or WebP format.

Post the same vertical video to Instagram Reels, YouTube Shorts and Facebook Reels in one call.

FAQ

Can I post publicly to TikTok without passing TikTok’s audit?

Yes. WoopSocial's TikTok integration is audited, so you simply authenticate an account and start publishing public content immediately, bypassing TikTok's Direct Post review.

Why are my API posts on TikTok private?

Apps that don't go through the Direct Post audit are required to post everything as SELF_ONLY (only the creator can see). Those apps are also limited to 5 users authorizing them per 24 hours. WoopSocial is already audited, so you can go with anything.

Can I schedule TikTok posts via API?

Yes. Set the schedule type to SCHEDULE_FOR_LATER, enter a UTC time-stamp, and WoopSocial will publish the post at that time with no scheduler that you need to host or develop. Retries will happen automatically in case any delivery fails for a temporary reason. Alternatively, you can also save the post as a draft first.

Can I post TikTok photo carousels?

Yes. Set postType to PHOTO and add up to 35 images, in JPEG or WebP format. The post will be published as a photo carousel, and all the scheduling, privacy, and disclosure options available to video posts are available to your photo posts as well.

Can I send a video to the TikTok inbox as a draft?

Yes. Change your postMode to MEDIA_UPLOAD instead of DIRECT_POST and the video will go straight to the creator’s TikTok inbox. They can add a sound, optimize the caption and publish it from the app which makes it a better approval step for agencies.

How do I label AI-generated or branded content?

Use the fields on the post request. Enable isAiGeneratedContent for AI-generated videos, isYourBrand when you're promoting your own business, and isBrandedContent for paid partnerships. WoopSocial submits them to TikTok along with the post, and the validation flags a missing toggle before anything goes live.

Can I post to multiple TikTok accounts?

Yes. The number of connected accounts depends on your plan - 2 for Free, 20 for Pro, 100 for Business and 2,500 for Max. Each account has a unique authorization URL, and one API key can publish to all of them, each on a separate schedule.

Does it include TikTok analytics?

Yes, at the post level. Each video gets views, likes, comments and shares, the four counters TikTok's API makes available per video. You won't find info on audience demographics, though, so turn to TikTok's own analytics in the app if you want follower data.

Can AI agents post to TikTok?

Yes. WoopSocial's MCP server is enabled in Claude, ChatGPT and Cursor, which means you can instruct your assistant to upload a video to TikTok using plain language. Our guide to scheduling social media posts with MCP covers setup, and there are pages for Hermes, Muse and Grok.

How do I get access to the TikTok Content Posting API?

To get access to the official TikTok Content Posting API, you would need to first register an app on TikTok for Developers, then add the Content Posting API product, then request access to video.publish or the video.upload scope. After that, a separate submission is require for TikTok to review your app. All your posts will stay private until you pass the Direct Post audit; there's also a limit of 5 users that can be authorized every 24 hours. But, with WoopSocial, you can just connect an account without having to through the entire auditing process yourself.

How long does the TikTok’s Direct Post audit take?

This can take anywhere from 2 to 6 weeks, but some people have reported that it can take even longer on that during busy weeks. TikTok can also reject your app, meaning you need to make changes and go back to the queue again. During the time your app is in audit, you can only post using SELF_ONLY. With WoopSocial's app, this audit has already been passed, so you can easily publish public posts from the second you connect your TikTok account(s).

Is the TikTok Content Posting API free?

TikTok does not charge for their API. The biggest cost on your end will be the engineering time: you need to pass the audit, set up refreshing 24-hours tokens, use chunk uploading for media and use polling for the posts' status. With WoopSocial, this is all handled for you, and you can use a free plan for up to 2 accounts or get a paid plan to get access to more.

What’s the difference between Direct Post and Upload to inbox?

Direct Post (this is postMode DIRECT_POST) will publish the video or photo post to your profile, now or at a later scheduled time, with the privacy level (public or private) that you select. Upload (postMode MEDIA_UPLOAD) sends it to your TikTok inbox first as a draft, so you can edit the video by adding sound for example, edit the caption and then publish it on the app. WoopSocial offers both types of uploading through the dashboard, API and MCP.

Post to more than TikTok

Same API key. Same request format. Same across all the networks listed below. One integration for all of these networks.

Start posting to TikTok today

“WoopSocial let me fully automate my social media posting, which is something I had been trying to get off my plate for a long time. I set it up once, and now posts go out without me touching anything day to day. Social went from a recurring chore to something that just runs in the background. That is the whole reason it stuck for me. What keeps me coming back is the trust. I do not have to log in and check whether something actually posted, because it always does. And on the rare occasion I have needed support, the team has been genuinely great to deal with. Thanks for building something this useful.”

Orkhan

Connect a TikTok account, grab a free API key and publish your first video in minutes. No Direct Post audit, no credit card.

Free plan · 2 accounts · No credit card · API + MCP included