Read TikTok Smart+ ad groups

POST

/api/v1/tiktok/smart/adgroups

Reads TikTok Upgraded Smart+ ad groups for a validated ad account owned by the authenticated external user. Filters supplied in the filtering object are forwarded verbatim to TikTok.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

TikTok Smart+ ad group list response payload.

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.adlyfy.dev/api/v1/tiktok/smart/adgroups' \
--header 'x-api-key;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "adAccountId": "7524374241765212177",
    "fields": [
        "adgroup_id",
        "adgroup_name",
        "primary_status"
    ],
    "filtering": {
        "campaign_ids": [
            "1234567890123456789"
        ]
    },
    "page": 1,
    "page_size": 100
}'

Response Example

{
    "data": {},
    "success": true,
    "message": "Request successful",
    "timestamp": "2026-03-30T12:00:00.000Z",
    "statusCode": 200
}

Modified at 2026-06-04 18:31:55

Update TikTok Smart+ campaign status

Create a TikTok Smart+ ad group