TOOL API

subscription_get

Gets the subscription details configured for a developer app from /v1.3/subscription/get/. Compared with v1.2, v1.3 changes the request parameter name from `object` to `subscribe_entity`, changes `app_id` from number to string, and renames response fields including `list` to `subscriptions`, `url` to `callback_url`, and `object` to `subscribe_entity`. In v1.3, `tcm_account_id` is deprecated in the response, and new response fields include `tto_tcm_account_id`, `lead_source`, `product_filters`, and `notify_frequency`.

ecommerceOAuth1 credits

Call information

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

Input parameters

app_idrequired

ID of your developer application.

page

Current page number. Defaults to `1`. Must be greater than or equal to 1.

page_size

Page size. Defaults to `10`. Valid range: 1-1000.

secretrequired

Secret of your developer application.

subscribe_entity

The object type to filter subscriptions by. Enum values: `REPORT_DATA_CHANGE` for changes in reporting metrics `spend`, `impressions`, `clicks`, and `video_play_actions` for one or more ad accounts; `AD_ACCOUNT_SUSPENSION` for ad account suspension status updates; `LEAD` for leads; `AD_GROUP` for ad group review status; `AD` for ad review status; `TCM_VIDEOS` for linking a TikTok video to a TTO campaign; `CREATIVE_FATIGUE` for fatigue status of an ad, ads in an ad group, or ads in an advertiser account; `API_SERVICE_STATUS` for API service status.