TOOL API

smart_plus_ad_create

Creates an Upgraded Smart+ ad. Checklist before calling: - `advertiser_id`, `adgroup_id` and `ad_name` are required. Pass `ad_name` as an empty string `""` to auto-generate the name; omitting the field fails. - `creative_info.ad_format=SINGLE_VIDEO` built from `video_info` requires exactly one `image_info` entry as the video cover. Omitting the cover fails. - Unless the creative references an existing TikTok post via `tiktok_item_id`, `ad_text_list` needs at least one `ad_text` of 1-100 characters without emojis. A Spark identity does not remove this requirement. - With a Spark identity (`TT_USER`, `BC_AUTH_TT`, `AUTH_CODE`) on an ad group that includes TikTok placement, the CTA must be `ad_configuration.call_to_action_id`: a CTA portfolio ID returned by `/creative/portfolio/create/` with `creative_portfolio_type=CTA`. `call_to_action_list` is rejected there whatever value it holds. - Non-Spark ads with `CUSTOMIZED_USER` identities are not supported on TikTok or Automatic placement; only Pangle-only and Global App Bundle ad groups accept them. Use a Spark identity elsewhere. Dependent resources: `/smart_plus/adgroup/get/` (placements, identity), `/creative/portfolio/create/` (CTA portfolio), `/file/video/ad/upload/`, `/file/image/ad/upload/`.

ecommerceOAuth1 credits

Call information

Tool slug
tiktok-ads.smart_plus_ad_create
Provider
TikTok for Business
Average response
0 ms
Calls in 7 days
0

Input parameters

ad_configuration

Additional configurations.

ad_name

Ad name. Always pass this field. If you want TikTok to auto-generate the name, pass an empty string (`""`); do not omit the field. Length limit: 512 characters, no emojis. Each Chinese or Japanese word counts as two characters; each English letter counts as one.

ad_text_list

Required when `tiktok_item_id` is not specified. List of ad texts shown with the ad creative. Max size: 5. Each item is an object, for example `[{"ad_text": "Shop the fall drop"}]`, not a bare string.

adgroup_idrequired

Ad group ID. Obtain valid IDs from `/smart_plus/adgroup/get/`.

advertiser_idrequired

Advertiser ID.

auto_message_list

Required when ad group `promotion_type` is `LEAD_GEN_CLICK_TO_TT_DIRECT_MESSAGE`. Automatic message details for TikTok Direct Messaging Ads. Max size: 1.

call_to_action_list

Call-to-action list. Max size: 3. Rejected, whatever value it holds, when the creative uses a Spark identity (`TT_USER`, `BC_AUTH_TT`, `AUTH_CODE`) and the ad group includes TikTok placement, or when the campaign objective is `LEAD_GENERATION` on TikTok placement. In those cases leave this field out and pass `ad_configuration.call_to_action_id` (a CTA portfolio ID). Sending a different call-to-action value does not help.

creative_list

List of creatives. Size range: 1-50.

custom_product_page_list

Custom product page details. Valid only for iOS app retargeting campaigns as documented. Size range: 0-1.

deeplink_list

List of deeplinks. Size range: 0-1.

disclaimer

Disclaimer information. Valid only when campaign `objective_type` is `APP_PROMOTION` or `WEB_CONVERSIONS`, or when campaign `objective_type` is `LEAD_GENERATION` and `catalog_enabled` is `false` or omitted; and the ad group includes TikTok placement either by leaving placement fields unspecified for automatic placement or by setting `placement_type=PLACEMENT_TYPE_NORMAL` and including `PLACEMENT_TIKTOK` in `placements`. Once added to the ad, the disclaimer cannot be deleted.

interactive_add_on_list

List of interactive add-on (creative portfolio) IDs. Size range: 0-1.

landing_page_url_list

Landing page URL list. Size range: 0-1. Each item is an object, for example `[{"landing_page_url": "https://example.com/fall"}]`, not a bare string.

operation_status

Status to apply when the ad is created. Defaults to `ENABLE`.

page_list

List of pages. Size range: 0-3.

playable_list

A list of playables.