TikTok

curl -X POST "https://api.sb/leaseline.app/posts/schedule?mode=try" \
  -H "Authorization: Bearer $SB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"handle":"tiktok:leaseline","format":"shortVideo","file":"files/clip-late-rent","body":"3 texts that end late rent #propertymanagement #landlord","at":"2026-10-29T23:00:00Z"}'

npx startup-builder do Post.schedule --try --data '{"handle":"tiktok:leaseline","format":"shortVideo","file":"files/clip-late-rent","body":"3 texts that end late rent #propertymanagement #landlord","at":"2026-10-29T23:00:00Z"}'

{
  "name": "do",
  "arguments": {
    "mode": "try",
    "code": "return await $.Post.schedule({ handle: 'tiktok:leaseline', format: 'shortVideo', file: 'files/clip-late-rent', body: '3 texts that end late rent #propertymanagement #landlord', at: '2026-10-29T23:00:00Z' })"
  }
}

import { $ } from 'startup-builder'

const result = await $.try.Post.schedule({ handle: 'tiktok:leaseline', format: 'shortVideo', file: 'files/clip-late-rent', body: '3 texts that end late rent #propertymanagement #landlord', at: '2026-10-29T23:00:00Z' })

 1{
 2  "$type": "Post",
 3  "mode": "try",
 4  "stored": false,
 5  "venue": "tiktok",
 6  "status": "scheduled",
 7  "at": "2026-10-29T23:00:00Z",
 8  "captionLength": 56,
 9  "steps": [
10    "sent to your TikTok inbox by API",
11    "posted publicly by the browser agent, signed in as you"
12  ],
13  "inboxWaiting": 1
14}

Connect onceCopy Anchor Link

1. Call Integration.connect with system: 'social' and venue: 'tiktok', then open the connectUrl it returns and sign in as the TikTok account you post from.
2. Sign in once more in the browser window the platform opens; that saved session presses Post on the clips your agents send.
3. Call Handle.connect to bind the account as your account.

What your agents doCopy Anchor Link

Calls on your own account are free.

Reading this site’s public data needs no account: Keyword.find, Keyword.search are Data calls (the three ways a call runs).

What it holdsCopy Anchor Link

Events and webhooksCopy Anchor Link

Any Event can wake a Workflow, and a Watch delivers it to your endpoint, signed (Events and webhooks).

LimitsCopy Anchor Link

Start hereCopy Anchor Link

Field mapCopy Anchor Link

What try does hereCopy Anchor Link

Checks the clip and caption against what your account reports it allows, and returns the post as it will show; nothing reaches your inbox.

How long a connection lastsCopy Anchor Link

A connection lasts 365 days from your first sign-in, the life of TikTok’s refresh token; the platform renews the 24-hour access token on its own.

The platform asks you to reconnect 7 days before it runs out; until you do, a call that needs it refuses with needs-reauth.

FormatsCopy Anchor Link

Plays and strategiesCopy Anchor Link

Used byCopy Anchor Link

No Workflow, agent task or Service acts through it yet: your agents call it directly.

ReferenceCopy Anchor Link

3 calls, each with its path and price

Call	Path	Price
Post.schedule	POST /posts/schedule	Free
Post.publish	POST /posts/publish	About 1.6¢ a step
Metric.query	POST /metrics/query	Free