Layers

Connect TikTok

OAuth a TikTok Business account for posting, comments, and video insights.

View as Markdown

Prerequisites

  1. Your TikTok account is a Business account (free; switch in TikTok app: Settings → Account → Switch to Business).
  2. You're an admin of the account.

Connect

  1. Project Settings → Social accounts → Connect TikTok.
  2. A TikTok OAuth window opens at tiktok.com/v2/auth/authorize/ (PKCE, S256 code challenge).
  3. Sign in.
  4. Approve the requested scopes.
  5. The window closes and the account appears in your connected list.

Scopes requested

Layers uses the TikTok Business login flow and requests the full scope set needed for publishing, engagement, and insights:

  • user.info.basic, user.info.username, user.info.stats, user.info.profile, user.account.type — profile + account info.
  • video.list, video.insights — read videos and their metrics.
  • video.publish, video.upload — publish and upload videos.
  • comment.list, comment.list.manage — read and reply to comments.
  • user.insights, biz.creator.info, biz.creator.insights, biz.brand.insights — creator / brand insights.
  • biz.ads.recommend, biz.spark.auth, tcm.order.update — ads-side interop for when the TikTok Ads layer is installed.

Posting

There are two publishing paths, controlled per scheduled post via the posting_mode metadata field:

  • automatic — when the slot comes due, Layers calls the TikTok Content Posting API to publish publicly. On failure, the post falls back to pending_manual for you to retry or finish manually.
  • manual (default) — at slot time Layers pushes the asset into the creator's TikTok drafts inbox. Open the TikTok app to review and post from there.

Disconnecting

Project Settings → Social accounts → row → Disconnect. Revokes the stored token and removes the account. Re-connect any time.

On this page