create_tiktok_campaign

POST https://api.adspirer.ai/api/v1/tools/create_tiktok_campaign/execute

User wants to create a TikTok ad campaign with IMAGES, Spark Ads, or Carousel ads (not video). LONG-RUNNING TOOL: Creates a TikTok In-Feed ad campaign with image creatives, Spark Ads (boost organic posts), or Carousel ads. Supported creative types: - Standard Image Ads: Provide asset_bundle_id or existing_image_ids - Spark Ads: Provide tiktok_item_id to boost an existing organic TikTok post as a paid ad - Carousel Ads: First call create_tiktok_carousel_card to get a card_id, then provide card_id + card_type here - App Promotion: Set objective=APP_PROMOTION + app_id for app install campaigns Emits MCP progress updates during campaign creation (typically 15-30 seconds). Progress stages: validate - commit. CRITICAL WARNING: - Call this tool ONLY ONCE per campaign - Creates REAL campaigns that cost REAL money - Do NOT retry automatically if errors occur - Report errors to user instead of retrying YOUR ROLE: TikTok Ads Campaign Strategist BEFORE calling this tool, YOU MUST: 1. Prepare Assets (choose ONE method): - METHOD A: Upload new images - Call `validate_and_prepare_tiktok_assets` with image URLs - Get `asset_bundle_id` - Use in create_tiktok_campaign - METHOD B: Reuse existing images - Call `discover_tiktok_assets` to browse library - Get `existing_image_ids` - Use in create_tiktok_campaign 2. Research the business: - Understand products/services, target audience - Review brand messaging and offers - Consider TikTok-specific creative best practices (authentic, engaging, mobile-first) 3. Craft compelling ad creative: - Ad text: 12-100 chars (50 or less recommended for no truncation) - Write for TikTok's young, mobile audience - Use casual, authentic language - Include clear call-to-action 4. Define targeting: - Locations: Default is USA, can specify others - Age groups: TikTok audience skews younger (18-34) - Gender: Unless product is gender-specific, use GENDER_UNLIMITED Required Fields: 1. campaign_name - Descriptive name (auto-suffixed with timestamp) 2. budget_daily - Minimum $20/day for image ads 3. ad_text - Main message (12-100 chars, 50 recommended) 4. display_name - Brand name (max 40 chars) 5. landing_page_url - HTTPS URL where users land 6. asset_bundle_id OR existing_image_ids - Choose one Optional Fields: - target_locations - List of TikTok location IDs (default: USA) - target_age_groups - Age ranges to target - target_gender - Gender targeting (default: all) - advertiser_id - TikTok advertiser account What happens when you call this tool: 1. Creates Campaign with daily budget 2. Creates Ad Group with targeting and auto-bidding 3. Uploads images to TikTok (if using asset_bundle_id) OR links existing images 4. Creates Ad with your creative 5. Campaign goes ACTIVE immediately Idempotency Support: - If creation fails partway, partial state is logged (campaign_id, ad_group_id) - You can retry with same parameters - system will resume from checkpoint - Prevents duplicate campaigns Execution time: 15-30 seconds (TikTok API has 10-second image processing wait) Error handling: - If validation fails: Error message with specific issue - If TikTok API fails: Error with partial state IDs for manual cleanup - Check TikTok Ads Manager for partial campaigns Best Practices: - Start with smaller budgets ($20-50/day) and scale what works - Test multiple ad variations (different images, text) - Monitor performance in TikTok Ads Manager after 2-3 days - TikTok learning phase is ~7 days - don't make changes too quickly - Use vertical 9:16 images - horizontal images won't work well

{
  "arguments": {
    "campaign_name": "string",
    "ad_text": "string",
    "display_name": "string",
    "landing_page_url": "https://example.com",
    "objective": "TRAFFIC",
    "app_id": "string",
    "app_promotion_type": "string",
    "budget_daily": 1.0,
    "budget_lifetime": 1.0,
    "schedule_end_time": "string"
  }
}

{
  "success": true,
  "data": {
    "text": "(tool-specific textual output for create_tiktok_campaign)",
    "quota": {
      "used": 42,
      "limit": 150,
      "tier": "plus",
      "period_end": "2026-05-01"
    }
  },
  "tool": "create_tiktok_campaign"
}

{
  "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": "create_tiktok_campaign"
}

{
  "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": "create_tiktok_campaign",
  "quota": {
    "used": 150,
    "limit": 150,
    "tier": "plus",
    "period_end": "2026-05-01",
    "upgrade_url": "https://adspirer.ai"
  }
}