Colours and fonts feed the brand.* tokens in templates; tone, do's/don'ts, glossary and forbidden words steer the localizer. Admin role for session users.
Parameters
brand_id
query
string
Request body · application/json
Field
Type
Description
name
string
min length 1
website
string | null
tone
string | null
dos
string[]
donts
string[]
forbidden_words
string[]
Block approval when any slot or caption contains one
glossary
object[]
Terms never translated (keep) or with fixed translations per language
hashtags
string[]
colors
object
Merged over the current colours; used by brand.* tokens
Creates a post and one variant per market. Each variant is localized (AI, your overrides, or the source text when the language matches / translate:false), rendered into the template, and submitted for approval.
media values may be an asset id or { "url": "https://…" } (imported first; needs assets:write).
markets accepts ids, language codes (de), country codes (DE) or ["all"].
Idempotency: when external_ref already exists the existing post is returned with HTTP 200 and "idempotent": true; new posts return 201.
Request body · application/json
Field
Type
Description
template_idrequired
string
System template (tpl_sys_…) or one of yoursmin length 1
brand_id
string
Defaults to the workspace's first brand
titlerequired
string
Internal title (not posted)min length 1 · max length 200
source_language
string
default "en" · pattern ^[a-z]{2}(-[A-Z]{2})?$
fields
map<string, string>
Text slot key → source textdefault {}
media
map<string, MediaRef>
Media slot key → asset id or { url }
caption
string
Source caption (localized per market)max length 2200
hashtags
string[] | string
Without #; market and brand hashtags are appended
brief
string
Extra guidance for localization, e.g. "mention the autumn deal"max length 2000
markets
string[] | string
Market ids, language codes, country codes, or ["all"] (default, unless locations is given)
locations
string[] | string
Location ids, slugs or external_ids, "all", or a market id/language/country (= its active locations). One version per location, posted to the location's own account; locations of one market are localized once
overrides
map<string, VariantOverride>
Keyed by market id, language or country code, or location id/slug/external_id
translate
boolean
false = never call the AI; markets without an override get the source text
ai_generated
boolean
Sets TikTok's AI-generated content label
brand_organic
boolean
"Promotional content" disclosure (default off)
schedule_at
number | string | null
ISO 8601 date-time (e.g. 2026-12-01T18:00:00+01:00), Unix milliseconds, or null
external_ref
string
Your id (CMS, PIM…). Idempotency key: re-sending returns the existing postmax length 200
auto_submit
boolean
Submit for approval automatically once rendered (default: market setting)
Example — AI localization for all markets
{
"template_id": "tpl_sys_bold_hook",
"title": "Autumn midweek deal",
"source_language": "en",
"fields": {
"hook": "Wake up *inside* the forest",
"body": "Midweek stays, three nights for the price of two.",
"cta": "Book in bio"
},
"media": {
"bg": {
"url": "https://cdn.example.com/photos/forest-dome.jpg"
}
},
"caption": "Three nights in the forest, pay for two. Monday to Thursday.",
"hashtags": [
"autumn",
"midweek"
],
"markets": [
"all"
],
"external_ref": "cms-4711"
}
Example — Your own translations
{
"template_id": "tpl_sys_bold_hook",
"title": "Autumn midweek deal (own translations)",
"source_language": "en",
"fields": {
"hook": "Wake up *inside* the forest",
"body": "Three nights for the price of two.",
"cta": "Book in bio"
},
"media": {
"bg": "ast_Q2w8Lm4Kx0Pz"
},
"caption": "Three nights in the forest, pay for two.",
"markets": [
"nl",
"de",
"gb"
],
"overrides": {
"nl": {
"fields": {
"hook": "Word wakker *midden* in het bos",
"body": "Drie nachten, betaal er twee.",
"cta": "Boek via bio"
},
"caption": "Drie nachten in het bos, betaal er twee."
},
"de": {
"fields": {
"hook": "Wach *mitten* im Wald auf",
"body": "Drei Nächte zum Preis von zwei.",
"cta": "Link in Bio"
},
"caption": "Drei Nächte im Wald, zahl nur zwei."
}
},
"translate": false,
"external_ref": "cms-4712"
}
Poll this (or use webhooks) to follow each market's status. preview_url / video_url are relative paths under the same host, authenticated like the API.
Locks the exact payload (account, video hash, final caption, disclosures, schedule) and adds it to the approval queue. Blocked while text checks have errors.