Log inStart Free Trial
easyCoexistence Official APIs

TikTok API for Business scopes: what each permission unlocks

TikTok's API for Business grants access in two layers. The developer app holds permissions under TikTok Accounts, such as Video Publish and Manage Account Comment, which open endpoints. The account owner's authorization gives the access token scopes, such as user.insights and video.list, which decide the fields returned. /tt_user/token_info/get/ lists the scopes a token carries.

easyCoexistence asks the TikTok account owner for the permissions its app holds in one sign-in, so Claude, ChatGPT or your own code can publish, work with comments and read insights through its tools, and get_social_credentials gives your own code the same token for other Accounts API endpoints.

18000000

Scope ID of TikTok Accounts, the first-level permission above the Accounts API's profile, post, comment and publishing endpoints.

user.account.type

Scope behind is_business_account and has_advanced_access in an account's profile data.

comment.list

Scope the owner must grant, and keep active, for the app to receive comment.update webhook events.

video.upload

Scope a token needs to upload a post as a draft instead of publishing it.

2 to 3 days

Business days TikTok's review of a change to a developer app's permissions may take.

What are the two layers of TikTok permissions?

App permissions and token scopes. App permissions are chosen under My Apps, the app, Scope of permission, and TikTok reviews them; they come in three levels, and a first-level permission covers every endpoint below it. Token scopes are what the account owner approved when authorizing the app, returned as scope, one comma-separated string, with each token. A call needs the app's permission for its endpoint, and some response fields also need a scope on the token.

Which app permission opens each endpoint?

TikTok's API reference lists, for each Accounts API endpoint, the permission under TikTok Accounts that opens it, or none. Its permission scope reference and webhook guide call the same groups Business User, Business Media, Business Comment and Business Content, so expect both sets of names:

Account User/business/get/: profile data and account insights
Get Account Media/business/video/list/: the account's posts and their metrics
Video Publish/business/video/publish/, /business/publish/status/, /business/video/settings/, hashtag suggestions and location tags
Photo Publish/business/photo/publish/
Get Business Comment/business/comment/list/ and /business/comment/reply/list/
Manage Account CommentCreating, replying to, liking, hiding and deleting comments, and comment image uploads
Business Benchmark/business/benchmark/: benchmarks for a business category
No permission needed/tt_user/token_info/get/, the URL property endpoints and the webhook configuration endpoints

Which token scopes unlock which fields?

TikTok's references for /business/get/ and /business/video/list/ give a required permission for each response field, and two other features name a scope of their own:

  • user.info.basic: display_name and profile_image.
  • user.info.username: username, which needed user.info.basic until June 2023.
  • user.info.profile: profile_deep_link, bio_description and is_verified.
  • user.info.stats: following_count, followers_count, total_likes and videos_count.
  • user.account.type: is_business_account and has_advanced_access.
  • user.insights: the daily account metrics and the follower breakdowns by age, gender, country and city.
  • video.list: post fields such as item_id, caption, share_url, likes, comments, shares, reach and video_views.
  • video.insights: watch time, the full-watch rate, retention, traffic sources, viewer breakdowns and the clicks a post drives.
  • comment.list: the comment.update webhook, described by TikTok as reading the comments and replies of in-app content.
  • video.upload: uploading a video or photo post as a draft, with upload_to_draft or is_draft.

How do you see the scopes on a token?

Ask /tt_user/token_info/get/, which takes the app_id and the access token and returns the token's scope and the account's creator_id. TikTok's example scope strings also include video.publish and comment.list.manage, whose names match the publishing and comment-management endpoints, though its references tie no field to either.

Read the scopes an access token carries
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/token_info/get/' \
  -H 'Content-Type: application/json' \
  -d '{"app_id": "<APP_ID>", "access_token": "<ACCESS_TOKEN>"}'

{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "app_id": "<APP_ID>",
    "creator_id": "<OPEN_ID>",
    "scope": "video.publish,user.info.basic,video.list,user.insights,comment.list.manage,video.insights,comment.list"
  }
}

What does easyCoexistence's TikTok connection ask for?

The permissions its developer app holds, all of them shown on TikTok's consent page. easyCoexistence sends the account owner to the TikTok account holder authorization URL that TikTok's portal generates for its app, which already names those permissions, and adds only a state value of its own. The owner approves what TikTok shows, and the scope string TikTok returns is stored with the connection. The endpoints easyCoexistence then calls for the account:

  • /business/get/ for the profile, daily metrics and follower breakdowns.
  • /business/video/list/ for posts and their metrics.
  • /business/video/publish/, /business/photo/publish/ and /business/publish/status/ for publishing.
  • /business/comment/list/, /business/comment/reply/create/, /business/comment/hide/ and /business/comment/delete/ for comments.
  • /business/webhook/update/, at app level, for the comment webhook.

How do you add a permission later?

In two steps, one per layer. For the app, open My Apps, the app, Scope of permission, edit it, give a reason that matches the new scopes and submit; TikTok's review may take two to three business days, and since March 20, 2026 a request that includes TikTok Accounts first needs the Accounts API Access Application Form. For the token, the owner authorizes the app again, since a token keeps the scopes approved when it was issued.

What happens when a permission is missing?

For a call, TikTok's return code is 40001, no permission to perform the related operation, and its fix points to the permission scope reference. For a field, the references make it available only once the owner has granted its scope, and their fix is to have the owner authorize the app again with that scope. Check the token's scope with /tt_user/token_info/get/ before asking.

Common mistakes

  • Expecting connected accounts to gain a new app permission on their own. Their tokens keep the scopes approved at authorization until each owner authorizes the app again.
  • Requesting is_business_account without user.account.type. TikTok makes that field and has_advanced_access available only to tokens carrying that scope.
  • Waiting for comment.update without comment.list. TikTok sends comment events only while the owner's authorization with that scope stays valid.
  • Searching the token for app permission names. The scope string uses names such as video.list, while names such as Get Account Media belong to the app's settings.
Doing this with EasyCoexistence

US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.

easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.

Frequently asked questions

What scopes does the TikTok API for Business use?

Token scopes such as user.info.basic, user.info.stats, user.insights, video.list, video.insights, comment.list and video.upload, granted by the account owner on top of the app's TikTok Accounts permissions.

Which permissions does TikTok's comment webhook need?

The app needs TikTok Accounts, Business Comment, and the owner must grant comment.list. Events stop if that authorization expires or is revoked.

Does a new TikTok scope apply to tokens already issued?

No. A token keeps the scopes approved when it was issued, so the account owner authorizes the app again to add a new one.

How long does TikTok take to approve a new permission?

TikTok says its review of a permission change may take two to three business days, and requests that add TikTok Accounts first need the Accounts API Access Application Form.

Keep reading

Connect your first channel in two minutes.

No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.

  • 3 days free
  • Cancel any time
  • Official APIs only
  • Monitored 24/7

Verified on