Contents
Product management guide to TikTok's restructured Smart+ Web Conversions API
Legacy /campaign/spc/create/ stops accepting new campaigns
March 31, 2026
Legacy update/status endpoints shut down
June 30, 2026
Manual Campaign Management API creation deprecated
December 31, 2026
| Feature | Legacy Smart+ | Upgraded Smart+ |
|---|---|---|
| API Structure | Single endpoint (/campaign/spc/create/) | Three endpoints (campaign, adgroup, ad) |
| Ad Groups per Campaign | 1 | Up to 30 |
| Budget Control | Campaign-level only | CBO or per-ad-group |
| Targeting | Automatic only | Automatic or manual |
| Creative per Ad | Limited | Up to 50 (video + carousel + post) |
| Ad Text Variations | Limited | Up to 5 |
| CTAs per Ad | Limited | Up to 3 standard |
TikTok replaced the legacy Smart+ Campaign Creation API with a three-endpoint structure: /v1.3/smart_plus/campaign/create/, /v1.3/smart_plus/adgroup/create/, and /v1.3/smart_plus/ad/create/.1 The legacy /campaign/spc/create/ endpoint stopped accepting new campaign creation on March 31, 2026.2 Legacy update and status-check endpoints remain functional until June 30, 2026.2 The Manual Campaign Management API creation endpoint is scheduled for deprecation on December 31, 2026.2
The restructured API separates campaign, ad group, and ad into independent objects, which enables up to 30 ad groups per campaign compared to the legacy limit of 1.1 Each ad group can carry its own budget, targeting, and optimization settings when Campaign Budget Optimization (CBO) is turned off.1
Access requires allowlisting — a TikTok sales representative must enable the feature for each advertiser account.1 Three developer app permissions are needed: Ads Management > Upgraded Smart Plus Ads, Reporting > Upgraded Smart+ Report, and Creative Management > Creative tool.1
Web Conversions campaigns require either a TikTok Pixel or the Events API to be installed and firing the target conversion event.3 The LANDING_PAGE optimization goal works only with the Pixel; the Events API alone does not support it.1 When both Pixel and Events API are active, event deduplication uses the event_id field and matches events received within a 48-hour window.5
All Web Conversions campaigns bill on Optimized Cost Per Mille (OCPM).1 Three optimization goals are available: CONVERT (optimizes toward a specified conversion event), LANDING_PAGE (optimizes toward landing page views, Pixel-only), and CLICK (optimizes toward link clicks).1
Cost Cap bidding is available only with daily budgets, not lifetime budgets.1 TikTok recommends setting daily budgets at a minimum of 10x historical CPA, with 30x as the target for Target CPA or Minimum ROAS bid strategies.4
When CBO is enabled, TikTok distributes the campaign budget across ad groups automatically.1 CBO imposes a uniformity constraint: all ad groups within the campaign must share identical values for promotion_type, optimization_goal, optimization_event, billing_event, bid_type, bid_price, conversion_bid_price, deep_bid_type, vbo_window, and roas_bid.1
When CBO is off, each ad group carries its own budget and can target different optimization goals or events independently.1 Use CBO when testing multiple audience segments against the same conversion event; use per-ad-group budgets when ad groups target different optimization events or require isolated spend control.
Automatic targeting delegates audience selection to TikTok's algorithm.3 It splits into two layers: "Audience Controls" (constraints the system guarantees, such as geo and age floors) and "Audience Suggestions" (hints the system may or may not follow, such as interest categories).1
Manual targeting gives direct control over demographics, interests, behaviors, and custom/lookalike audiences at the ad group level.1 Manual targeting is available only in the Upgraded Smart+ API; the legacy Smart+ API supported automatic targeting exclusively.1
Each ad supports up to 50 creative assets combined across video, carousel, and TikTok Post formats.1 Carousel ads accept up to 35 images plus 1 music track.1 Up to 5 ad text variations and up to 3 standard CTAs can be assigned per ad.1
Spark Ads (ads that boost organic TikTok posts) and non-Spark ads cannot coexist in the same campaign.1 Identity types for Spark Ads include CUSTOMIZED_USER, AUTH_CODE, TT_USER, and BC_AUTH_TT.1
After launch, TikTok recommends making no edits to a campaign for 7 days to allow the learning phase to complete.4 After the learning phase, bid adjustments should stay within 15% of the current value and occur no more frequently than every 2 days.4
What breaks and when:
/campaign/spc/create/ endpoint rejects new campaign creation requests.2 Existing legacy campaigns continue to run./campaign/spc/update/) and status endpoints stop functioning.2 Any automation relying on these endpoints must migrate before this date.Fallback path: Between March 31 and June 30, 2026, legacy campaigns already created can still be updated and monitored through the old endpoints.2 No new legacy campaigns can be created after March 31, 2026.2
event_id for deduplication.5The Upgraded Smart+ Web Conversions API adds three capabilities the legacy API lacked: multi-ad-group campaigns (up to 30 per campaign), per-ad-group budget and targeting control, and manual targeting for web conversion objectives.1 Creative flexibility increased to 50 assets per ad with up to 5 text variations and 3 CTAs.1 The migration is mandatory, with the first hard deadline on March 31, 2026 for new campaign creation.2
TikTok replaced the legacy Smart+ Campaign Creation API with a three-endpoint structure: /v1.3/smart_plus/campaign/create/, /v1.3/smart_plus/adgroup/create/, and /v1.3/smart_plus/ad/create/.1 The legacy /campaign/spc/create/ endpoint stopped accepting new campaign creation on March 31, 2026.2 Legacy update and status-check endpoints remain functional until June 30, 2026.2 The Manual Campaign Management API creation endpoint is scheduled for deprecation on December 31, 2026.2
Legacy /campaign/spc/create/ stops accepting new campaigns
March 31, 2026
Legacy update/status endpoints shut down
June 30, 2026
Manual Campaign Management API creation deprecated
December 31, 2026
| Feature | Legacy Smart+ | Upgraded Smart+ |
|---|---|---|
| API Structure | Single endpoint (/campaign/spc/create/) | Three endpoints (campaign, adgroup, ad) |
| Ad Groups per Campaign | 1 | Up to 30 |
| Budget Control | Campaign-level only | CBO or per-ad-group |
| Targeting | Automatic only | Automatic or manual |
| Creative per Ad | Limited | Up to 50 (video + carousel + post) |
| Ad Text Variations | Limited | Up to 5 |
| CTAs per Ad | Limited | Up to 3 standard |
The restructured API separates campaign, ad group, and ad into independent objects, which enables up to 30 ad groups per campaign compared to the legacy limit of 1.1 Each ad group can carry its own budget, targeting, and optimization settings when Campaign Budget Optimization (CBO) is turned off.1
Access requires allowlisting — a TikTok sales representative must enable the feature for each advertiser account.1 Three developer app permissions are needed: Ads Management > Upgraded Smart Plus Ads, Reporting > Upgraded Smart+ Report, and Creative Management > Creative tool.1
Web Conversions campaigns require either a TikTok Pixel or the Events API to be installed and firing the target conversion event.3 The LANDING_PAGE optimization goal works only with the Pixel; the Events API alone does not support it.1 When both Pixel and Events API are active, event deduplication uses the event_id field and matches events received within a 48-hour window.5
All Web Conversions campaigns bill on Optimized Cost Per Mille (OCPM).1 Three optimization goals are available: CONVERT (optimizes toward a specified conversion event), LANDING_PAGE (optimizes toward landing page views, Pixel-only), and CLICK (optimizes toward link clicks).1
Cost Cap bidding is available only with daily budgets, not lifetime budgets.1 TikTok recommends setting daily budgets at a minimum of 10x historical CPA, with 30x as the target for Target CPA or Minimum ROAS bid strategies.4
When CBO is enabled, TikTok distributes the campaign budget across ad groups automatically.1 CBO imposes a uniformity constraint: all ad groups within the campaign must share identical values for promotion_type, optimization_goal, optimization_event, billing_event, bid_type, bid_price, conversion_bid_price, deep_bid_type, vbo_window, and roas_bid.1
When CBO is off, each ad group carries its own budget and can target different optimization goals or events independently.1 Use CBO when testing multiple audience segments against the same conversion event; use per-ad-group budgets when ad groups target different optimization events or require isolated spend control.
Automatic targeting delegates audience selection to TikTok's algorithm.3 It splits into two layers: "Audience Controls" (constraints the system guarantees, such as geo and age floors) and "Audience Suggestions" (hints the system may or may not follow, such as interest categories).1
Manual targeting gives direct control over demographics, interests, behaviors, and custom/lookalike audiences at the ad group level.1 Manual targeting is available only in the Upgraded Smart+ API; the legacy Smart+ API supported automatic targeting exclusively.1
Each ad supports up to 50 creative assets combined across video, carousel, and TikTok Post formats.1 Carousel ads accept up to 35 images plus 1 music track.1 Up to 5 ad text variations and up to 3 standard CTAs can be assigned per ad.1
Spark Ads (ads that boost organic TikTok posts) and non-Spark ads cannot coexist in the same campaign.1 Identity types for Spark Ads include CUSTOMIZED_USER, AUTH_CODE, TT_USER, and BC_AUTH_TT.1
After launch, TikTok recommends making no edits to a campaign for 7 days to allow the learning phase to complete.4 After the learning phase, bid adjustments should stay within 15% of the current value and occur no more frequently than every 2 days.4
What breaks and when:
/campaign/spc/create/ endpoint rejects new campaign creation requests.2 Existing legacy campaigns continue to run./campaign/spc/update/) and status endpoints stop functioning.2 Any automation relying on these endpoints must migrate before this date.Fallback path: Between March 31 and June 30, 2026, legacy campaigns already created can still be updated and monitored through the old endpoints.2 No new legacy campaigns can be created after March 31, 2026.2
event_id for deduplication.5The Upgraded Smart+ Web Conversions API adds three capabilities the legacy API lacked: multi-ad-group campaigns (up to 30 per campaign), per-ad-group budget and targeting control, and manual targeting for web conversion objectives.1 Creative flexibility increased to 50 assets per ad with up to 5 text variations and 3 CTAs.1 The migration is mandatory, with the first hard deadline on March 31, 2026 for new campaign creation.2