TOOL API

adgroup_status_update

Enables, disables, or deletes ad groups through `/open_api/v1.3/adgroup/status/update/`. Use it to resume delivery, pause delivery, or delete ad groups. Ad groups in Dedicated Campaigns cannot be deleted with this endpoint; delete the campaign instead. The operation status of a deleted ad group, or an ad group in a deleted campaign, cannot be modified. You can check campaign or ad group `operation_status` with `/campaign/get/` or `/adgroup/get/`.

ecommerceOAuth1 credits

Call information

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

Input parameters

adgroup_idsrequired

IDs of the ad groups to operate on. Size range: 1-20.

advertiser_idrequired

Advertiser ID.

allow_partial_success

Whether to allow partial success when operating on multiple ad groups. Default is `false`. If `true`, some specified ad groups may succeed while ineligible ad groups are filtered out.

operation_statusrequired

Operation to perform on the ad groups. `DISABLE` pauses delivery, `ENABLE` resumes delivery, and `DELETE` deletes the ad group. The status of deleted ad groups, or ad groups in deleted campaigns, cannot be modified. `ENABLE` and `DISABLE` are not supported for R&F ad groups.