Skip to main content

TikTok for Business

Marketing/Ads API connector for TikTok for Business — manage advertisers, identities, campaigns, ad groups, and ads; run reporting; manage custom audiences, creative libraries (images/videos), pixels and pixel events; and read Business Center data.

Categories: Advertising, Marketing

📝 Beta: This connector is in beta. It follows the service's documented API but has not yet been fully tested against the live service, so some tools may behave differently than described.

What you can ask​

  • List the active campaigns for advertiser 7012345678901234567 with their budgets
  • Pull spend, impressions, and conversions for each ad group over the last 7 days
  • Pause every ad group with a cost per conversion above $30

Set up​

TikTok for Business connects with credentials from your TikTok for Business account. Have these values ready:

  • Environment
  • App ID
  • Advertiser ID
  • Access token
  • App secret
  1. Go to Organization > Connectors and find TikTok for Business.
  2. Click Enable and choose which tools to allow.
  3. Each member enters their own values the first time they use it.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

Tools​

TikTok for Business offers 41 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (19)​

View and search information without changing it.

ToolWhat it does
get_advertiser_infoGet detailed account info (name, company, currency, timezone, status) for one or more advertiser IDs.
get_custom_audiencesGet details for specific custom audiences by ID.
get_image_infoGet info for specific image IDs (max 100).
get_pixel_event_statsGet pixel event statistics for up to 10 pixels over a UTC date range (start_date/end_date 'YYYY-MM-DD', span <= 30 days).
get_reportRun a synchronous integrated report for an advertiser.
get_video_infoGet info for specific video IDs.
list_adgroupsList ad groups for an advertiser with pagination.
list_adsList ads for an advertiser with pagination.
list_authorized_advertisersList advertiser (ad account) IDs the access token is authorized to manage.
list_bc_assetsList assets (advertiser accounts, catalogs, pixels, etc.) a user can access under a Business Center.
list_bc_membersList members of a Business Center.
list_business_centersList the Business Centers the access token can access, with pagination.
list_campaignsList campaigns for an advertiser with pagination.
list_custom_audiencesList custom audiences for an advertiser with pagination.
list_identitiesList identities (posting entities used when creating ads) for an advertiser.
list_pixelsList pixels for an advertiser with pagination.
search_imagesSearch an advertiser's image library.
search_videosSearch an advertiser's video library.
validate_credentialValidate TikTok for Business credentials by listing the advertisers the access token can manage.

Write (10)​

Create or send data.

ToolWhat it does
create_adCreate an ad under an ad group.
create_adgroupCreate an ad group under a campaign.
create_campaignCreate a campaign under an advertiser.
create_lookalike_audienceCreate a lookalike audience from a source custom audience.
create_pixelCreate a pixel for an advertiser.
create_pixel_eventCreate events on a pixel.
create_rule_audienceCreate a rule-based (engagement) custom audience.
share_custom_audiencesShare custom audiences to other advertiser accounts.
upload_imageUpload an image to the advertiser's library from a public URL (upload_type UPLOAD_BY_URL).
upload_videoUpload a video to the advertiser's library from a public URL (upload_type UPLOAD_BY_URL).

Delete or overwrite (12)​

Remove or replace existing data.

ToolWhat it does
delete_custom_audiencesPermanently delete custom audiences by ID.
unshare_custom_audiencesStop sharing a custom audience with an advertiser account.
update_adUpdate an ad incrementally (only the fields you pass change).
update_ad_statusEnable, disable (pause), or delete an ad.
update_adgroupUpdate an ad group's name, budget, bid, or schedule.
update_adgroup_budgetUpdate an ad group's budget.
update_adgroup_statusEnable, disable (pause), or delete an ad group.
update_campaignUpdate a campaign's name, budget_mode, or budget.
update_campaign_statusEnable, disable (pause), or delete a campaign.
update_custom_audienceUpdate a custom audience (currently its name).
update_pixelUpdate a pixel's name.
update_pixel_eventUpdate a pixel event's name/conversion fields.
⌘J