campaign_copy_task_create

Ignored when `deep_copy_mode` is `DEFAULT` or omitted. Required when `deep_copy_mode` is `CUSTOM`. Customized settings for ad groups in the new campaign. Max size 20.

Advertiser ID.

Budget for the new campaign. If omitted, defaults to the original campaign's budget.

ID of the source campaign to copy. You cannot copy GMV Max campaigns with customized TikTok posts; check /campaign/gmv_max/info/ and confirm `custom_anchor_video_list` is `[]`. You cannot copy iOS Dedicated Campaigns whose apps have not activated the SAN module on your MMP. Starting September 30, 2024, campaigns containing Playable Ads delivered to TikTok placement can no longer be copied. Only campaigns with objectives `REACH`, `TRAFFIC`, `VIDEO_VIEWS`, `ENGAGEMENT`, `APP_PROMOTION`, `LEAD_GENERATION`, and `WEB_CONVERSIONS` are supported. For `ENGAGEMENT`, ad groups with `promotion_type` = `LIVE_SHOPPING` or `optimization_goal` = `PAGE_VISIT` cannot be copied. Smart+ campaigns are not supported. The source campaign must have at least one undeleted ad group with at least one undeleted ad, should not exceed 20 undeleted ad groups with up to 50 undeleted ads per ad group, and cannot include ACO ad groups, though Smart Creative ad groups are supported. If the campaign contains ad groups bound to a split test, only the ad groups are copied; split test groups are not created.

Name of the new campaign. Max length 512 characters; emojis are not supported. Each Chinese or Japanese word counts as 2 characters and each English letter counts as 1. If omitted, defaults to `"COPIED_{{name_of_the_original_campaign}}"`.

Copy mode. Default is `DEFAULT`. `DEFAULT` copies all undeleted ad groups and ads from the original campaign and ignores `adgroup_list`. `CUSTOM` copies only the specified undeleted ad groups and ads, and requires `adgroup_list`. In `CUSTOM`, you can copy at most 20 ad groups and 50 ads per ad group.

Whether to enable Advanced Dedicated Campaign for the new campaign. If omitted, the copied campaign inherits this setting from the original campaign. Once set, this field cannot be updated.

Status of the new campaign when created. Default is `DISABLE`. To change status later, use /campaign/status/update/.

PO (purchase order) number for invoice tracking and reconciliation.

Idempotency key for preventing duplicate submissions. If you retry with the same value within the 10-second cache window, only one request succeeds. After the cache expires, the same value is treated as a new request. This is different from the response `request_id`, which identifies the HTTP request. Must be a string representation of a 64-bit integer, for example `"123456789"`.

Realtime API (RTA) strategy ID. This is an allowlist-only feature; you must complete RTA onboarding to receive and respond to RTA requests, and available IDs are obtained through your TikTok representative.

Required and valid only when `virtual_objective_type` is specified. Sales destination for the new campaign. `APP` requires a product catalog.

Required when top-level `schedule_type` is `SCHEDULE_START_END`. Not supported when top-level `schedule_type` is `SCHEDULE_FROM_NOW`. Shared end time (UTC+0) for all new ad groups, format `"YYYY-MM-DD HH:MM:SS"`. Cannot be later than `"2038-01-01 00:00:00"`.

Required when top-level `schedule_type` is provided. Shared start time (UTC+0) for all new ad groups, format `"YYYY-MM-DD HH:MM:SS"`. Can be up to 12 hours earlier than the current time, but not later than `"2028-01-01 00:00:00"`.

Use this only when you want the same schedule for all new ad groups. If you want per-ad-group schedules, specify `schedule_type` inside each `adgroup_list` item instead. When set to `SCHEDULE_START_END`, you must also provide both `schedule_start_time` and `schedule_end_time`. When set to `SCHEDULE_FROM_NOW`, you must provide `schedule_start_time`, and the end time is automatically set to 10 years later.

New objective type. Use this field to create the copied campaign with the Sales objective, which combines Website Conversions and Product Sales.