For Agents
Create and manage TikTok ad campaigns, ad groups, ads, audiences, and creatives, run Smart+ campaigns, and pull reporting data on behalf of an authorized advertiser.
Use for: I need to create a TikTok ad campaign, Pause an ad group whose performance has dropped, List all my TikTok ads with their current status, Pull last week's spend report for an ad account
Not supported: Does not handle organic TikTok content posting, creator-economy payouts, or non-ad analytics - use for TikTok ad operations and Business Center management only.
The TikTok Marketing API is TikTok's advertising and Business Center API for managing the full TikTok Ads stack: ad accounts, campaigns, ad groups, ads, Smart+ campaigns, creatives, audiences, pixels, catalogs, automated rules, comments, and reporting. It also exposes Business Center, app, and offline events endpoints for advertisers running cross-account or attribution workflows. Authentication uses an Access-Token header issued through the TikTok OAuth flow against /oauth2/access_token/.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the TikTok Marketing API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fbusiness-api.tiktok.com%2Ftiktok-marketing" | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fbusiness-api.tiktok.com%2Ftiktok-marketing" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with TikTok Marketing API.
Create, list, and update TikTok ad campaigns and update their status
Manage ad groups and ads, including bulk status updates
Run Smart+ campaigns and ad groups via the /smart_plus paths
Manage audiences, pixels, and catalogs for ad targeting and product feeds
Pull reporting data and apply automated rules across the ad account
Manage creatives, including comments and blocked words
Operate Business Center entities for multi-account advertisers
Patterns agents use TikTok Marketing API for, with concrete tasks.
★ Programmatic TikTok ad campaign management
Create campaigns, ad groups, and ads, then update their status as performance changes. The campaign, adgroup, and ad endpoints each expose create, list, update, and status-update operations, suitable for performance teams that orchestrate dozens or hundreds of ad units across multiple advertisers.
POST /campaign/create/ for the new objective, POST /adgroup/create/ under it, POST /ad/create/ for each creative, then POST /ad/status/update/ to enable them.
Smart+ automated campaigns
Run TikTok Smart+ campaigns where the platform optimizes targeting and creative selection. The /smart_plus/campaign and /smart_plus/adgroup endpoints mirror the standard create-list-update-status pattern but route to TikTok's automated optimization stack, suitable for teams that want simpler campaign management with platform-driven optimization.
POST /smart_plus/campaign/create/ with budget and objective, POST /smart_plus/adgroup/create/ under it, then activate with POST /smart_plus/campaign/status/update/.
Reporting and pixel-driven attribution
Pull spend, reach, and conversion data via the Reporting endpoints, and feed in offline conversions through the offline-events endpoints to attribute back to TikTok ads. Pair with pixel and audience endpoints to close the loop on retargeting and lookalike-style audiences.
Pull a campaign-level report from the Reporting endpoints for the last 7 days, then post matching offline events through the offline-events endpoint to attribute store visits.
AI agent ad operations via Jentic
An AI agent can manage day-to-day TikTok ad operations - pausing underperforming ad groups, building lookalike audiences, and adjusting Smart+ campaigns - without ever holding the raw Access-Token. Jentic securely stores the access token and refresh material and issues scoped, short-lived credentials per operation.
Search Jentic for 'pause a TikTok ad group', load the /adgroup/status/update/ schema, and execute the pause for the chosen ad group ID after the user confirms.
155 endpoints — the tiktok marketing api is tiktok's advertising and business center api for managing the full tiktok ads stack: ad accounts, campaigns, ad groups, ads, smart+ campaigns, creatives, audiences, pixels, catalogs, automated rules, comments, and reporting.
METHOD
PATH
DESCRIPTION
/oauth2/access_token/
Exchange OAuth code for an access token
/campaign/create/
Create a campaign
/campaign/get/
List campaigns
/adgroup/create/
Create an ad group
/adgroup/status/update/
Update ad group status
/ad/create/
Create an ad
/smart_plus/campaign/create/
Create a Smart+ campaign
/ad/status/update/
Update ad status
/oauth2/access_token/
Exchange OAuth code for an access token
/campaign/create/
Create a campaign
/campaign/get/
List campaigns
/adgroup/create/
Create an ad group
/adgroup/status/update/
Update ad group status
/ad/create/
Create an ad
/smart_plus/campaign/create/
Create a Smart+ campaign
/ad/status/update/
Update ad status
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the TikTok Marketing API by hand means running the OAuth exchange at /oauth2/access_token/, scoping calls to an authorized advertiser via /oauth2/advertiser/get/, sending the Access-Token header on every request, and handling per-advertiser 429 throttling yourself. Through Jentic you install once, import the TikTok Marketing API from the API Directory, store the access token once, and your agent calls it.
Permission scoping
TikTok carries the advertiser and entity ids in the request body rather than the URL path, so you limit the agent to the operations it needs, such as GET /campaign/get/ to list campaigns or POST /adgroup/status/update/ to pause one. Write and status operations like POST /campaign/create/ or /ad/status/update/ stay out of reach unless you add them.
Credential isolation
Your TikTok Access-Token and OAuth refresh material are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'create a TikTok campaign' or 'pause a TikTok ad group', and Jentic returns the matching operation like POST /campaign/create/ or /adgroup/status/update/ with its input schema, so the agent calls the right endpoint without reading the TikTok developer portal.
Alternatives and complements available in the Jentic catalogue.
Specific to using TikTok Marketing API through Jentic.
What authentication does the TikTok Marketing API use?
Requests carry an Access-Token header obtained via the TikTok OAuth flow at /oauth2/access_token/. List authorized advertisers with /oauth2/advertiser/get/. Through Jentic, the access token and refresh material are encrypted in the vault and a scoped, short-lived token is issued per operation.
Can I create and manage TikTok ad campaigns through this API?
Yes - POST /campaign/create/ to create a campaign, GET /campaign/get/ to list, POST /campaign/update/ to edit, and POST /campaign/status/update/ to enable, pause, or delete. Ad groups and ads expose the same create-list-update-status pattern.
What is Smart+ and how do I run it via the API?
Smart+ is TikTok's automated campaign optimization stack. Use /smart_plus/campaign/create/ and /smart_plus/adgroup/create/ to set up Smart+ entities; status and update operations mirror the standard ad surface.
How do I pull spend or performance data from a TikTok ad account?
Use the Reporting endpoints, which return aggregated metrics by campaign, ad group, or ad over a date range. Pair with the pixel and offline-events endpoints to attribute conversions to specific ads.
What are the rate limits for the TikTok Marketing API?
The OpenAPI spec does not declare explicit limits. TikTok publishes per-app and per-advertiser quotas in their developer documentation - implement 429 retry-with-backoff and stagger reporting pulls to avoid spikes.
How do I create a TikTok campaign through Jentic?
Run `pip install jentic` and search for 'create a TikTok campaign'. Jentic returns the /campaign/create/ operation, you load its schema, and execute with the campaign payload - credentials stay in your Jentic One instance.
GET STARTED