Integration Walkthrough
TikTok OAuth + Upload API Walkthrough
This page shows live OAuth consent, connected account status, and official TikTok Content Posting API flows for both Upload Inbox and Direct Post.
This view preserves the TikTok walkthrough form across same-tab OAuth return and hides noisy debug panels so the reviewer video stays focused on the required end-to-end flow.
This mode shows a clearly labeled end-to-end reviewer mockup on the live production site when TikTok sandbox consent is unavailable. No real TikTok upload or account mutation occurs in this mode.
Readiness
OAuth Config
--Backend Session Workers
This page runs on the backend directly so your team can validate OAuth and uploads without opening the full Hive UI.
Step 1: Connect TikTok Account (OAuth)
Preferred path for TikTok Content Posting API. This captures OAuth tokens for Upload API usage.
OAuth Session
---{}
Step 2: Review Connected TikTok Accounts
| ID | Username | Status | Proxy | OAuth Scope | Token Expiry | OpenID |
|---|---|---|---|---|---|---|
| No TikTok accounts loaded yet. | ||||||
Step 3: Publish Flow
Pull the TikTok creator limits before selecting privacy or posting settings.
Load creator info to pull privacy options and creator-specific interaction rules from TikTok. Privacy is not preselected.
------{}
Choose the post title, manually select an allowed privacy level, and manually enable any interactions TikTok allows.
Privacy stays unselected until creator info loads. Only me can be chosen unless Branded content is selected.
All interaction checkboxes start off. Posting Suite greys out any interaction TikTok reports as unavailable in creator settings.
Commercial content stays off by default. Private visibility disables only Branded content, and selecting Branded content makes Only me unavailable.
Commercial content disclosure stays off by default. Turn it on only when the post promotes yourself, a brand, product, or service.
The declaration below changes with the commercial-content selection and must be accepted before publish.
Direct Post remains disabled until the commercial-content choice is valid and music consent is checked.
Review the exact request state before Posting Suite sends the Direct Post request.
-------The publish button stays blocked until the reviewer-visible requirements above are satisfied.
After you finish publishing, TikTok may take a few minutes to process the content and make it visible on your profile.
Recommended flow: use Upload API inbox and let creators finish the post in TikTok, including sound selection.
Direct Post uses the same official Content Posting API, but publishes directly to the creator profile once `video.publish` is approved.
Fallback option: manual export renders final assets and a publish checklist so your team can post manually when needed.
Bundled production demo clip path:
/app/server-tiktok-hive/review-demo/demo-assets/review-upload-sample.mp4
Run Output
--{}
After the publish request finishes, TikTok may take a few minutes to process the content and make it visible on the TikTok profile.
Walkthrough Notes
Suggested demo sequence
- Show this page URL and readiness panel (client key/secret + redirect URI configured).
- Click Start TikTok OAuth, complete consent in popup, return to this page.
- Show the newly connected TikTok account in the accounts table with scopes.
- Run Direct Post or Upload to TikTok Inbox with a sample MP4 path.
- Show successful publish/upload result and explain whether the creator finishes in TikTok or the post publishes directly.
If live sandbox consent is blocked, click Start Review Mockup and then Run Mockup Upload to demonstrate the same reviewer path with explicit mockup labels.
Why this flow is production-friendly
- Explicit user consent via TikTok OAuth (PKCE).
- Uses official Content Posting API scopes (`video.upload` and `video.publish`).
- Supports both creator-controlled inbox flow and direct publish flow.
- Matches the app domain/backend where the integration actually runs.
Rotate the client secret if it was ever exposed outside your local environment.