- Home
- Skills
- APIs & Backend
- TikTok Content Posting API
Works with the AI Agents you already use
TikTok Content Posting API
Add "Post to TikTok" to your app and pass TikTok's app review the first time.
$6.70
TikTok Content Posting API
Example session with this skill installed
Our TikTok direct post fails with unaudited_client_can_only_post_to_private_accounts even though we send privacy_level SELF_ONLY. Why, and what do we need to do to post publicly?
- Read your context and instructions
- Compiled the tiktok content posting
Summary
Your app hasn't passed TikTok's audit, and the
TikTok account itself is public. Before the audit, TikTok requires both: the post must be SELF_ONLY
and the posting account must be private. Sending SELF_ONLY alone isn't enough, so /v2/post/publish/video/init/ refuses the request.
Fix it today (testing)
- In the TikTok app for the posting account: Profile → ☰ → Settings and privacy → Privacy → Private account: on.
- Make sure the account is a
Sandbox target user (Developer portal → your app → Sandbox → Target users), or sign-in fails with non_sandbox_target.
3. Re-run creator_info. A private account returns FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS, SELF_ONLY. If "Everyone" (PUBLIC_TO_EVERYONE) still appears, the account is still public.
4. Post again with privacy_level: "SELF_ONLY".
Show it to users as an action, not a code
case "unaudited_client_can_only_post_to_private_accounts":
return "This app can only post privately until TikTok approves it. Choose Only me, and make sure the TikTok account is private.";
Post publicly (permanent fix): pass the audit
| Step | What to do |
|---|---|
| Posting screen | Fresh creator_info on open, nickname shown, privacy with no default, Comment/Duet/Stitch unchecked, disclosure toggle with "Promotional content" / "Paid partnership" labels, consent line above Post, no upload before the click |
| Scopes | Only user.info.basic, video.publish, video.upload. Remove anything "Import from Sandbox" added (user.info.profile, user.info.stats, video.list), or the review stalls |
| URLs | Verify a URL prefix with a trailing slash (https://app.example.com/); terms and privacy must sit under it |
| Demo video | A Sandbox recording of the full flow: connect, posting screen, every toggle, post, the result on TikTok |
| Submit | A reason of 120 characters at most, e.g. "First release: Login Kit and Content Posting API (Direct Post and drafts) for creators posting their own videos." |
Next steps
- I can check your posting screen against
reference/posting-screen.mdand list what's missing. - After approval, switch to the
Production client key and secret and have users reconnect, because Sandbox tokens don't carry over.
Connects securely to your tools. The creator never sees your data.
About this skill
Add "Post to TikTok" to your app and pass TikTok's app review the first time.
TikTok's Content Posting API has strict rules: a required posting screen with exact wording, chunk-size maths, private-only posting until you're audited, and a review that rejects apps for one unused scope. This skill gives your agent the whole playbook:
- API flow: Login Kit OAuth (including the hex-encoded PKCE challenge desktop apps need), creator info, Direct Post, drafts to the inbox, the 5/64/128 MB chunk rules, status polling and every rate limit.
- The required posting screen: every Content Sharing Guidelines rule with TikTok's exact strings for the disclosure labels, hover texts and consent line, plus a dependency-free React component.
- App review: Sandbox target users, URL-prefix verification (and the trailing-slash trap), the production form, a scope explanation template, a shot-by-shot demo video plan, the 120-character submission reason, and when to recall.
- Errors: every error and fail_reason code mapped to a fix and a message users understand.
- Typed Node client: fetch-based, no SDK, calls only TikTok's own endpoints, with server-side checks for consent, privacy options, duration and branded content.
What's in the zip
SKILL.md: when to use it and the step-by-step workflowreference/api-flow.md: endpoints, payloads, chunk maths, polling, limitsreference/posting-screen.md: the UX checklist with TikTok's exact stringsreference/app-review.md: portal, sandbox, URL verification, the form, the demo video, submitting and recallingreference/errors.md: error codes and fail_reason values, each with a fixexamples/tiktok-client.ts: a Node 18+ client (type-checked)examples/PostToTikTok.tsx: the posting screen as a React component (type-checked)
Written while shipping a real integration through TikTok's review. It includes the mistakes that cost days: scopes added silently by "Import from Sandbox", the 5-drafts-per-day cap, and unaudited apps posting only to private accounts. Facts are checked against TikTok's current docs, and the skill tells your agent to re-check anything time-sensitive. Not affiliated with TikTok.
Client secrets must remain server-side. Direct Post is limited to private accounts and Sandbox users until the app audit passes. TikTok docs change frequently; verify latest rate limits.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed 8 days ago
Requires
Permissions
Allowed Hosts
The skill itself is guidance plus example code: your agent reads the reference files and writes TikTok integration code into your project (read/write files, shell for type-checks). The example client, when you run it, calls only TikTok's official API (open.tiktokapis.com) and the upload URL TikTok returns, using your user's access token. It never handles your client_secret and sends nothing anywhere else.