TOOL API
smart_
Updates an Upgraded Smart+ Ad via `/open_api/v1.3/smart_plus/ad/update/`. This endpoint supports incremental updates overall, but `creative_list`, `ad_configuration.product_info`, and `ad_configuration.product_info.promo_info_list` use full-replacement update mode, so when updating any field inside them you must resubmit the complete value or sibling data will be lost. Updating `product_info` or `promo_info_list` triggers ad review again. Important deprecation notice: creating non-Spark Ads using Custom Identities in ad groups that deliver to Automatic Placement or Select Placement when TikTok is included is no longer supported for existing ad accounts. All new ad accounts created on or after January 15, 2026 cannot create non-Spark Ads using Custom Identities for these placements. Existing ads remain unaffected and editable. Ad campaigns that deliver only to Pangle or Global App Bundle placements are not affected by this Custom Identity deprecation. Migrate guidance: https://business-api.tiktok.com/portal/docs?id=1848048566169730
Call information
- Tool slug
- tiktok-ads.smart_plus_ad_update
- Provider
- TikTok for Business
- Average response
- 0 ms
- Calls in 7 days
- 0
Input parameters
ad_configurationAdditional ad configuration.
ad_nameAd name. Max length 512 characters; cannot contain emojis. Each Chinese or Japanese word counts as two characters, and each English letter counts as one.
ad_text_listList of ad texts shown as part of the creatives. Max size: 5.
advertiser_idrequiredAdvertiser ID.
call_to_action_listList of call-to-actions. Max size: 3. In TikTok placement scenarios described above, this field is unsupported and you must use `ad_configuration.call_to_action_id` instead.
creative_listList of creatives. Size range: 1-50. Full-replacement update mode: if you update any field inside `creative_list`, you must resubmit the complete `creative_list` value.
custom_product_page_listDetails of the custom product page to use in the ad. Valid only for APP_RETARGETING campaigns with an iOS app. Size range: 0-1.
deeplink_listList of deeplinks. Size range: 0-1.
disclaimerDisclaimer information. Valid only when the campaign objective is `APP_PROMOTION` or `WEB_CONVERSIONS`, or `LEAD_GENERATION` with `catalog_enabled=false` or omitted, and the ad group includes TikTok placement either through automatic placement or `PLACEMENT_TYPE_NORMAL` with `PLACEMENT_TIKTOK`. You cannot remove a disclaimer added at creation, and you cannot change `disclaimer_type` between `TEXT_ONLY` and `TEXT_LINK` after it exists. You can only add a disclaimer to an ad that does not already have one, or update the existing disclaimer text and URL where applicable.
interactive_add_on_listList of interactive add-on (creative portfolio) IDs. Size range: 0-1.
landing_page_url_listLanding page URL list. Size range: 0-1.
page_listList of pages. Size range: 0-3.
playable_listValid only in any of the following scenarios: Scenario 1: At the campaign level, objective_type is APP_PROMOTION. At the ad group level, the placement is not Global Apple Bundle-only (with placement_type as PLACEMENT_TYPE_NORMAL and placements as ["PLACEMENT_GLOBAL_APP_BUNDLE"]) . At the ad level, ad_format is SINGLE_VIDEO and a video or video post is specified. Scenario 2: At the campaign level, objective_type is APP_INSTALL. At the ad group level: promotion_type is MINI_GAME. The placement is not Global Apple Bundle-only (with placement_type as PLACEMENT_TYPE_NORMAL and placements as ["PLACEMENT_GLOBAL_APP_BUNDLE"]) . At the ad level, ad_format is SINGLE_VIDEO and a video or video post is specified. The list of playables. Max size: 5.
smart_plus_ad_idrequiredAd ID to update.