Merge has validated TikTok for Business against the provider’s documented API and not yet verified it against the live one, so its behavior can differ from the documentation. It carries the same tool surface it will have at general availability. Connectors overview covers the tier and how to turn Beta Connectors off.
Authentication: Access token. See Magic Link for the runtime auth flow.
Sample use cases
- List the active campaigns for advertiser
7012345678901234567with 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
Available Tools
Create an ad under an ad group. Requires advertiser_id, adgroup_id and ad_name, plus the creative fields: identity_ty…
Create an ad group under a campaign. Requires advertiser_id, campaign_id, adgroup_name, optimization_goal, billing_ev…
Create a campaign under an advertiser. Requires advertiser_id, campaign_name, objective_type, and budget_mode. Use li…
Create a lookalike audience from a source custom audience. Requires custom_audience_name, source_audience_id and look…
Create a pixel for an advertiser. Requires pixel_name (max 40 chars, no emojis, unique per advertiser). Returns the n…
Create events on a pixel. Requires pixel_id and pixel_events - a list of event objects each requiring ‘event_type’ (s…
Create a rule-based (engagement) custom audience. Requires custom_audience_name, audience_type (e.g. ‘ENGAGEMENT’), a…
Permanently delete custom audiences by ID. Requires custom_audience_ids. This is destructive and cannot be undone.
Get detailed account info (name, company, currency, timezone, status) for one or more advertiser IDs. Use list_author…
Get details for specific custom audiences by ID. Requires custom_audience_ids. Returns the audiences’ full details.
Get info for specific image IDs (max 100). Requires image_ids. Returns the images’ details.
Get pixel event statistics for up to 10 pixels over a UTC date range (start_date/end_date ‘YYYY-MM-DD’, span = 30 day…
Run a synchronous integrated report for an advertiser. Requires data_level (AUCTION_ADVERTISER/AUCTION_CAMPAIGN/AUCTI…
Get info for specific video IDs. Requires video_ids. Returns the videos’ details.
List ad groups for an advertiser with pagination. Requires advertiser_id; use list_authorized_advertisers to find val…
List ads for an advertiser with pagination. Requires advertiser_id; use list_authorized_advertisers to find valid IDs…
List advertiser (ad account) IDs the access token is authorized to manage. Call this first to discover the advertiser…
List assets (advertiser accounts, catalogs, pixels, etc.) a user can access under a Business Center. Requires bc_id a…
List members of a Business Center. Requires bc_id. Optional filters: keyword, user_role (‘ADMIN’|‘STANDARD’), relatio…
List the Business Centers the access token can access, with pagination. Returns business centers and page_info.
List campaigns for an advertiser with pagination. Requires advertiser_id; use list_authorized_advertisers to find val…
List custom audiences for an advertiser with pagination. Optionally filter by custom_audience_ids (the get-by-ID path…
List identities (posting entities used when creating ads) for an advertiser. Use list_authorized_advertisers to find…
List pixels for an advertiser with pagination. Optional filters: pixel_id, name (fuzzy), order_by (‘EARLIEST_CREATE’…
Search an advertiser’s image library. Optional filters: image_ids, material_ids, displayable. Returns images and page…
Search an advertiser’s video library. Optional filters: video_ids, material_ids, video_name (fuzzy), sort_field (‘CRE…
Share custom audiences to other advertiser accounts. Requires custom_audience_ids and shared_advertiser_ids (the acco…
Stop sharing a custom audience with an advertiser account. Requires custom_audience_id (find it with list_custom_audi…
Update an ad incrementally (only the fields you pass change). Requires adgroup_id and ad_id; optional: ad_name, ad_te…
Enable, disable (pause), or delete an ad. Requires advertiser_id, ad_id, and operation_status. Use list_ads to find a…
Update an ad group’s name, budget, bid, or schedule. Requires advertiser_id and adgroup_id; all other fields are opti…
Update an ad group’s budget. Requires advertiser_id, adgroup_id, budget_mode (‘BUDGET_MODE_DAY’ or ‘BUDGET_MODE_TOTAL…
Enable, disable (pause), or delete an ad group. Requires advertiser_id, adgroup_id, and operation_status. Use list_ad…
Update a campaign’s name, budget_mode, or budget. Requires advertiser_id and campaign_id; use list_campaigns to find…
Enable, disable (pause), or delete a campaign. Requires advertiser_id, campaign_id, and operation_status. Use list_ca…
Update a custom audience (currently its name). Requires custom_audience_id; custom_audience_name is optional. Returns…
Update a pixel’s name. Requires pixel_id and pixel_name (empty string keeps the name unchanged). Returns the updated…
Update a pixel event’s name/conversion fields. Requires event_id and event_name; currency and currency_value optional…
Upload an image to the advertiser’s library from a public URL (upload_type UPLOAD_BY_URL). Requires image_url; file_n…
Upload a video to the advertiser’s library from a public URL (upload_type UPLOAD_BY_URL). Requires video_url; file_na…