select_google_campaign_type

Google Ads Read

**USE THIS TOOL FIRST WHEN:** User wants to create a Google Ads campaign but hasn't specified the campaign type (Search, Performance Max, or YouTube)

Endpoint

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

Headers

Description

**USE THIS TOOL FIRST WHEN:** User wants to create a Google Ads campaign but hasn't specified the campaign type (Search, Performance Max, or YouTube). **IMPORTANT:** This tool should be called BEFORE any keyword research, asset discovery, or campaign creation when the user says things like: - "Create a Google Ads campaign" - "I want to run Google Ads" - "Set up a Google advertising campaign" - "Help me create ads on Google" - "I want to advertise on Google" - "Create a campaign" - "Run ads" This tool guides the user to select their campaign TYPE, then provides a detailed workflow for that specific type. **Campaign Types Available:** 1. **search** - Text ads in Google Search results (best for high-intent keywords, lead gen, local services) 2. **pmax** - Performance Max across all Google channels (best for ecommerce, brand awareness, multi-channel reach) 3. **youtube** - Video ads on YouTube (best for video content, brand storytelling, product demos) **Returns:** - What the campaign type is best for - Step-by-step workflow with which tools to call - Requirements (character limits, assets needed, etc.) - Natural follow-up question to start the creation flow **Do NOT use this tool if:** - User specifically asks for "search campaign" or "text ads" → go directly to research_keywords then create_search_campaign - User specifically asks for "PMax" or "Performance Max" → go directly to discover_existing_assets then create_pmax_campaign - User specifically asks for "YouTube campaign" or "video campaign" → go directly to validate_video then create_youtube_campaign - User is asking about performance/analytics → use get_campaign_performance - User is asking about existing campaigns → use list_campaigns **Parameters:** - campaign_type: 'search', 'pmax', or 'youtube' **Execution time:** Instant (no API call)

Request body

All tool arguments are wrapped in an arguments object.

FieldTypeDescription
campaign_typestring requiredType of Google Ads campaign to create. Options: 'search' (text ads in search results), 'pmax' (Performance Max across all Google channels), 'youtube' (video ads on YouTube)

Example request

{
  "arguments": {
    "campaign_type": "string"
  }
}

Example responses

200 — Success

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

400 — Tool-level error (bad arguments / multi-account selection)

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

402 — Quota exhausted

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

Try it live


Adspirer REST API — get an API key at adspirer.ai/keys · adspirer.ai