Schedule content

Schedule TikTok video posts with one hosted workspace.

SocialClaw supports TikTok video posting only. The route uses one video per post, a public or SocialClaw-hosted video URL, and the current TikTok privacy and interaction settings surface.

Try the CLI Open dashboard

Account type TikTok user account One video per post

Best fit Developer tools TikTok video is the only supported media type in the current SocialClaw flow.

What SocialClaw supports for this workflow

A quick overview of what this workflow supports.

Account target TikTok user account The workflow uses a connected TikTok account inside the SocialClaw workspace.

Media rule Video only TikTok requires a public video URL or a SocialClaw-hosted video URL.

Settings privacyLevel and interaction toggles Inspect privacyLevel, duetEnabled, commentEnabled, and stitchEnabled before apply.

Inspection Validate before publish Use capabilities and validation before apply so the route does not promise unsupported TikTok media shapes.

What the payload needs

The main fields and constraints to account for.

tiktok:@handle target in the workspace
One public or SocialClaw-hosted video URL
Optional privacyLevel, duetEnabled, commentEnabled, and stitchEnabled settings
Validation before apply

How the workflow runs

Connect the account, validate the post, then publish.

Step 1

Connect the TikTok account

Start the hosted TikTok OAuth flow and keep the connected account inside the workspace.

Step 2

Prepare a public video URL

Use a public video URL or upload the video to SocialClaw so TikTok can pull it from a hosted public URL.

Step 3

Validate the scheduled post

Validation confirms that the route is still video-only and that the account can publish with the supplied settings.

Step 4

Apply and inspect the run

Create the scheduled TikTok post, then inspect the resulting run and post record after publish.

CLI and HTTP examples

Example commands and requests for this route.

CLI flow Schedule videos on TikTok

socialclaw accounts connect --provider tiktok --open
socialclaw assets upload --file ./clip.mp4 --json
socialclaw validate -f tiktok-video-schedule.json --json
socialclaw apply -f tiktok-video-schedule.json --idempotency-key tiktok_launch_1 --json

HTTP API flow Hosted SocialClaw endpoints

curl -sS \
  -X POST \
  -H "Authorization: Bearer $SC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tiktok"}' \
  "https://getsocialclaw.com/v1/connections/start"

curl -sS \
  -X POST \
  -H "Authorization: Bearer $SC_API_KEY" \
  -H "Content-Type: application/json" \
  -d @tiktok-video-schedule.json \
  "https://getsocialclaw.com/v1/posts/validate"