TikTok Ads Write
Update TikTok ad group settings: name, budget, targeting (age, gender, locations), schedule
POST https://api.adspirer.ai/api/v1/tools/update_tiktok_ad_group/execute
Authorization: Bearer sk_live_... — your Adspirer API key (required)Content-Type: application/json (required)Idempotency-Key: <uuid> — recommended for write operations to make retries safeAll tool arguments are wrapped in an arguments object.
| Field | Type | Description |
|---|---|---|
adgroup_id | string required | TikTok ad group ID |
name | string optional | New ad group name |
budget | number optional | New budget in account currency |
age_groups | array optional | Age groups: AGE_13_17, AGE_18_24, AGE_25_34, AGE_35_44, AGE_45_54, AGE_55_100 |
gender | string optional | GENDER_MALE, GENDER_FEMALE, or GENDER_UNLIMITED |
location_ids | array optional | TikTok location IDs |
schedule_end_time | string optional | End time: YYYY-MM-DD HH:MM:SS |
advertiser_id | string optional | TikTok advertiser ID. Required for multi-account users. Get from list_connected_accounts. |
{
"arguments": {
"adgroup_id": "string",
"name": "string",
"budget": 1.0,
"age_groups": [
"string"
],
"gender": "string",
"location_ids": [
"string"
],
"schedule_end_time": "string"
}
}
{
"success": true,
"data": {
"text": "(tool-specific textual output for update_tiktok_ad_group)",
"quota": {
"used": 42,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01"
}
},
"tool": "update_tiktok_ad_group"
}
{
"success": false,
"error": "You have 25 meta_ads accounts connected. Please specify which account to use by passing the ad_account_id parameter:\n - Acme Holdings (ad_account_id=\"act_123456789\")\n - Acme EU (ad_account_id=\"act_987654321\")",
"is_error": true,
"tool": "update_tiktok_ad_group"
}
{
"success": false,
"error": "\ud83d\udea8 Monthly limit reached (150/150 tool calls on Plus tier).\nUpgrade to Pro at https://adspirer.ai to keep building.",
"is_error": true,
"tool": "update_tiktok_ad_group",
"quota": {
"used": 150,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01",
"upgrade_url": "https://adspirer.ai"
}
}
Interactive: Swagger UI
Machine-readable: OpenAPI 3.1 spec · llms-full.txt
More tools: TikTok Ads · All tools
Adspirer REST API — get an API key at adspirer.ai/keys · adspirer.ai