> This page is for Agent Handler. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.merge.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server. # TikTok for Business > **This Connector is in Beta** > > 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](/merge-agent-handler/connectors/overview) covers the tier and how to turn Beta Connectors off. **Authentication:** Access token. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow. ## Sample use cases * 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 ## Available Tools #### create_ad Create an ad under an ad group. Requires advertiser_id, adgroup_id and ad_name, plus the creative fields: identity_ty... #### create_adgroup Create an ad group under a campaign. Requires advertiser_id, campaign_id, adgroup_name, optimization_goal, billing_ev... #### create_campaign Create a campaign under an advertiser. Requires advertiser_id, campaign_name, objective_type, and budget_mode. Use li... #### create_lookalike_audience Create a lookalike audience from a source custom audience. Requires custom_audience_name, source_audience_id and look... #### create_pixel Create a pixel for an advertiser. Requires pixel_name (max 40 chars, no emojis, unique per advertiser). Returns the n... #### create_pixel_event Create events on a pixel. Requires pixel_id and pixel_events - a list of event objects each requiring 'event_type' (s... #### create_rule_audience Create a rule-based (engagement) custom audience. Requires custom_audience_name, audience_type (e.g. 'ENGAGEMENT'), a... #### delete_custom_audiences Permanently delete custom audiences by ID. Requires custom_audience_ids. This is destructive and cannot be undone. #### get_advertiser_info Get detailed account info (name, company, currency, timezone, status) for one or more advertiser IDs. Use list_author... #### get_custom_audiences Get details for specific custom audiences by ID. Requires custom_audience_ids. Returns the audiences' full details. #### get_image_info Get info for specific image IDs (max 100). Requires image_ids. Returns the images' details. #### get_pixel_event_stats Get pixel event statistics for up to 10 pixels over a UTC date range (start_date/end_date 'YYYY-MM-DD', span = 30 day... #### get_report Run a synchronous integrated report for an advertiser. Requires data_level (AUCTION_ADVERTISER/AUCTION_CAMPAIGN/AUCTI... #### get_video_info Get info for specific video IDs. Requires video_ids. Returns the videos' details. #### list_adgroups List ad groups for an advertiser with pagination. Requires advertiser_id; use list_authorized_advertisers to find val... #### list_ads List ads for an advertiser with pagination. Requires advertiser_id; use list_authorized_advertisers to find valid IDs... #### list_authorized_advertisers List advertiser (ad account) IDs the access token is authorized to manage. Call this first to discover the advertiser... #### list_bc_assets List assets (advertiser accounts, catalogs, pixels, etc.) a user can access under a Business Center. Requires bc_id a... #### list_bc_members List members of a Business Center. Requires bc_id. Optional filters: keyword, user_role ('ADMIN'|'STANDARD'), relatio... #### list_business_centers List the Business Centers the access token can access, with pagination. Returns business centers and page_info. #### list_campaigns List campaigns for an advertiser with pagination. Requires advertiser_id; use list_authorized_advertisers to find val... #### list_custom_audiences List custom audiences for an advertiser with pagination. Optionally filter by custom_audience_ids (the get-by-ID path... #### list_identities List identities (posting entities used when creating ads) for an advertiser. Use list_authorized_advertisers to find... #### list_pixels List pixels for an advertiser with pagination. Optional filters: pixel_id, name (fuzzy), order_by ('EARLIEST_CREATE'... #### search_images Search an advertiser's image library. Optional filters: image_ids, material_ids, displayable. Returns images and page... #### search_videos Search an advertiser's video library. Optional filters: video_ids, material_ids, video_name (fuzzy), sort_field ('CRE... #### share_custom_audiences Share custom audiences to other advertiser accounts. Requires custom_audience_ids and shared_advertiser_ids (the acco... #### unshare_custom_audiences Stop sharing a custom audience with an advertiser account. Requires custom_audience_id (find it with list_custom_audi... #### update_ad Update an ad incrementally (only the fields you pass change). Requires adgroup_id and ad_id; optional: ad_name, ad_te... #### update_ad_status Enable, disable (pause), or delete an ad. Requires advertiser_id, ad_id, and operation_status. Use list_ads to find a... #### update_adgroup Update an ad group's name, budget, bid, or schedule. Requires advertiser_id and adgroup_id; all other fields are opti... #### update_adgroup_budget Update an ad group's budget. Requires advertiser_id, adgroup_id, budget_mode ('BUDGET_MODE_DAY' or 'BUDGET_MODE_TOTAL... #### update_adgroup_status Enable, disable (pause), or delete an ad group. Requires advertiser_id, adgroup_id, and operation_status. Use list_ad... #### update_campaign Update a campaign's name, budget_mode, or budget. Requires advertiser_id and campaign_id; use list_campaigns to find... #### update_campaign_status Enable, disable (pause), or delete a campaign. Requires advertiser_id, campaign_id, and operation_status. Use list_ca... #### update_custom_audience Update a custom audience (currently its name). Requires custom_audience_id; custom_audience_name is optional. Returns... #### update_pixel Update a pixel's name. Requires pixel_id and pixel_name (empty string keeps the name unchanged). Returns the updated... #### update_pixel_event Update a pixel event's name/conversion fields. Requires event_id and event_name; currency and currency_value optional... #### upload_image Upload an image to the advertiser's library from a public URL (upload_type UPLOAD_BY_URL). Requires image_url; file_n... #### upload_video Upload a video to the advertiser's library from a public URL (upload_type UPLOAD_BY_URL). Requires video_url; file_na...