TikTok Ads

curl -X POST "https://api.sb/leaseline.app/campaigns/create?mode=try" \
  -H "Authorization: Bearer $SB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"venue":"tiktok","objective":"traffic","budget":{"amount":25,"currency":"USD","per":"day"},"days":7,"ads":["posts/tiktok-late-rent"]}'

npx startup-builder do Campaign.create --try --data '{"venue":"tiktok","objective":"traffic","budget":{"amount":25,"currency":"USD","per":"day"},"days":7,"ads":["posts/tiktok-late-rent"]}'

{
  "name": "do",
  "arguments": {
    "mode": "try",
    "code": "return await $.Campaign.create({ venue: 'tiktok', objective: 'traffic', budget: { amount: 25, currency: 'USD', per: 'day' }, days: 7, ads: ['posts/tiktok-late-rent'] })"
  }
}

import { $ } from 'startup-builder'

const result = await $.try.Campaign.create({ venue: 'tiktok', objective: 'traffic', budget: { amount: 25, currency: 'USD', per: 'day' }, days: 7, ads: ['posts/tiktok-late-rent'] })

 1{
 2  "$type": "Campaign",
 3  "mode": "try",
 4  "stored": false,
 5  "venue": "tiktok",
 6  "format": "Spark Ad",
 7  "adGroupBudget": {
 8    "amount": 25,
 9    "currency": "USD",
10    "per": "day"
11  },
12  "campaignBudget": "unset",
13  "total": {
14    "amount": 175,
15    "currency": "USD"
16  },
17  "checks": {
18    "adGroupFloor": "over the $20 floor"
19  },
20  "runsBy": "browser",
21  "steps": 16
22}

Connect onceCopy Anchor Link

1. Call Integration.connect with system: 'ads' and venue: 'tiktok', then open the connectUrl it returns and sign in as yourself with TikTok for Business.
2. Authorize the ad account, then sign in once more in the browser window the platform opens; that saved session builds the Spark Ads.
3. Set the spend on your standing approval with Mandate.authorize; TikTok bills your ad account, never the platform.

What your agents doCopy Anchor Link

Calls on your own account are free; TikTok bills your spend directly.

Reading this site’s public data needs no account: Ad.find is a Data call (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

Returns the Spark Ad and its ad group as Ads Manager will hold them, checked against TikTok’s budget floors, with the steps the browser agent would take; nothing is created.

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

4 calls, each with its path and price

Call	Path	Price
Campaign.create	POST /campaigns/create	About 1.6¢ a step
Ad.create	POST /ads/create	About 1.6¢ a step
Campaign.update	POST /campaigns/update	About 1.6¢ a step
Metric.query	POST /metrics/query	Free