API referenceTikTok Business

GET /api/v1/accounts/{id}/tiktok-business/permissions

Re-reads the permissions the account granted to its token (/tt_user/token_info/get/), stores them as the account's scopes and lists what is missing: missingPermissions (permission and the features it blocks), notGranted (every scope Postgale requests but the token lacks). TikTok Business permissions come from the scopes configured on the TikTok for Business app and the account owner's consent

GET
/api/v1/accounts/{id}/tiktok-business/permissions

Authorization

BearerAuth
headerAuthorizationBearer <token>

API key sk_...

Path Parameters

id*string

Account id

Response Body

TikTokBusinessPermissions

application/json
  1. response
accountId?string
platform?string
checkedAt?string
granted?array<string>
missingPermissions?array<>
notGranted?array<string>
Example Request
curl -X GET 'https://example.com/api/v1/accounts/string/tiktok-business/permissions'
Example Response
{  "accountId": "string",  "platform": "string",  "checkedAt": "string",  "granted": [    "string"  ],  "missingPermissions": [    {      "permission": "string",      "features": [        "string"      ]    }  ],  "notGranted": [    "string"  ]}

DELETE /api/v1/accounts/{id}/tiktok-business/posts/{postId}/ad-authorization DELETE

Deletes the post's Spark Ads authorization code (/business/post/authorize/delete/). Queued for approval (202) while approval applies

GET /api/v1/accounts/{id}/tiktok-business/insights GET

Stored daily account insights (synced from /business/get/ every TIKTOK_BUSINESS_INSIGHTS_SYNC_HOURS): daily video views, profile views, likes, comments, shares, new/lost followers..., their totals over the window and the follower counts. Read-only, no platform call