Skip to content

Error reference

Permission not granted

This TikTok account was connected without the permission this action needs. Direct Post must be enabled on the TikTok app, then the account reconnected so TikTok grants the video.publish permission.

Code
tiktok_scope_not_authorized
HTTP status
409
Category
conflict
Severity
warn
Retryable
No
Domain
connections

How to fix

Review the request and try again. The response `detail` explains the specific problem.

Example response

Every error is returned as application/problem+json (RFC 9457). The detail is the specific, actionable message; the code is stable and safe to branch on.

{
  "type": "https://skedcast.com/errors/tiktok_scope_not_authorized",
  "title": "Permission not granted",
  "status": 409,
  "category": "conflict",
  "code": "tiktok_scope_not_authorized",
  "detail": "This TikTok account was connected without the permission this action needs. Direct Post must be enabled on the TikTok app, then the account reconnected so TikTok grants the video.publish permission.",
  "correlationId": "c-1f2e3d4c-…",
  "severity": "warn"
}

Handle it in code

try {
  await skedcast.posts.create(input);
} catch (err) {
  if (err instanceof SkedcastApiError && err.code === 'tiktok_scope_not_authorized') {
    // This TikTok account was connected without the permission this action needs. Direct Post must be enabled on the TikTok app, then the account reconnected so TikTok grants the video.publish permission.
  }
}