Schedule content

Schedule TikTok videos and photo galleries with one hosted workspace.

SocialClaw supports one TikTok video or one to 35 TikTok photos per post, public or SocialClaw-hosted media URLs, and the current TikTok privacy, interaction, music, and disclosure settings surface.

Try the CLI Open dashboard

Account type TikTok user account One video or up to 35 photos per post

Best fit Developer tools TikTok posts require either one public video URL or one to 35 public image URLs.

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 or photo gallery TikTok accepts one public video URL or one to 35 public image URLs, including SocialClaw-hosted delivery URLs.

Settings Privacy, interactions, music, and cover Inspect privacyLevel, interaction toggles, autoAddMusic, and photoCoverIndex 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, or one to 35 public image URLs
Optional privacyLevel, duetEnabled, commentEnabled, stitchEnabled, autoAddMusic, and photoCoverIndex 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 public media URLs

Use one public video URL or a photo gallery, or upload the media to SocialClaw so TikTok can pull hosted delivery URLs.

Step 3

Validate the scheduled post

Validation confirms the one-video or photo-gallery media shape 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"

Current limitations

A few practical limits to keep in mind.

TikTok posts require either one public video URL or one to 35 public image URLs.
Photo posts can enable TikTok-recommended music with autoAddMusic, but the API does not expose choosing a specific song or sound.
Non-post interaction steps are not implemented.