TikTok

Connect your TikTok account to schedule and publish posts through Cue.

Overview

TikTok is a short-form video platform where you can share creative video content with your audience. Cue integrates with the TikTok API to publish content on your behalf.

Authentication

TikTok uses OAuth 2.0 for secure authentication. You don't need to create API credentials - Cue handles this for you.

Connecting Your Account

Go to Profiles in your Cue dashboard
Click Connect Account on a profile
Select TikTok
You'll be redirected to TikTok to authorize access
Sign in and grant Cue permission to post on your behalf
You'll be redirected back to Cue automatically

Your credentials are never shared with Cue.

Permissions

Cue requests the following permissions:

video.publish - Publish videos to your account
user.info.basic - Read your basic profile information

Disconnecting

To disconnect your TikTok account, go to your profile and click Disconnect next to the TikTok connection. This revokes Cue's access to your account.

You can also revoke access from TikTok Settings under Security and login > Manage app permissions.

Content Limits

TikTok enforces the following limits on posts:

Limit	Value
Caption	2,200 characters
Hashtags	100 per post
Video length	10 minutes
File size	4 GB (video)
Aspect ratio	9:16 (recommended)
Resolution	1080x1920 (recommended)

Cue automatically validates your content before publishing to prevent errors.

Publishing a Post

curl -X POST https://api.oncue.so/v1/posts \
  -H "Authorization: Bearer cue_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "prf_abc123",
    "platforms": {
      "sac_tiktok1": {
        "items": [{ "content": "Check out this amazing video!" }]
      }
    },
    "publishNow": true
  }'

const response = await fetch("https://api.oncue.so/v1/posts", {
  method: "POST",
  headers: {
    Authorization: "Bearer cue_sk_your_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    profileId: "prf_abc123",
    platforms: {
      sac_tiktok1: {
        items: [{ content: "Check out this amazing video!" }],
      },
    },
    publishNow: true,
  }),
});

Schedule for Later

curl -X POST https://api.oncue.so/v1/posts \
  -H "Authorization: Bearer cue_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "prf_abc123",
    "platforms": {
      "sac_tiktok1": {
        "items": [{ "content": "Scheduled TikTok video" }]
      }
    },
    "scheduledAt": "2024-01-20T09:00:00-05:00"
  }'

const response = await fetch("https://api.oncue.so/v1/posts", {
  method: "POST",
  headers: {
    Authorization: "Bearer cue_sk_your_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    profileId: "prf_abc123",
    platforms: {
      sac_tiktok1: {
        items: [{ content: "Scheduled TikTok video" }],
      },
    },
    scheduledAt: "2024-01-20T09:00:00-05:00",
  }),
});

Response

{
  "data": {
    "id": "pst_xyz789",
    "profileId": "prf_abc123",
    "content": "Check out this amazing video!",
    "status": "queued",
    "scheduledAt": null,
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-15T10:00:00Z"
  },
  "message": "Post queued for publishing to 1 platform(s)"
}

Error Handling

TikTok API errors are translated into user-friendly messages:

Error Code	Meaning	Solution
`401`	Authentication failed	Reconnect your TikTok account
`403`	Account restricted	Check your TikTok account status
`400`	Content validation failed	Check video format and caption length
`429`	Rate limit exceeded	Wait and retry later