Skip to main content
The list_campaigns tool retrieves all campaigns from your Google Ads account. Your AI assistant calls this tool whenever you ask to see, review, or filter your campaigns.

​
Parameters

​
status
string
Filter campaigns by status. Accepted values: ENABLED, PAUSED, REMOVED. If omitted, all campaigns are returned regardless of status.
​
customer_id
string
The 10-digit Google Ads account ID (without dashes). Uses the account from your configuration if not specified.

​
Example prompts

List all my active campaigns

Show me paused campaigns in my account

What campaigns do I have?

​
Example response

[
  {
    "id": "12345678",
    "name": "Summer Sale",
    "status": "ENABLED",
    "daily_budget_micros": 50000000,
    "daily_budget": 50.00,
    "currency": "USD",
    "bidding_strategy": "TARGET_CPA",
    "target_cpa_micros": 15000000,
    "campaign_type": "SEARCH",
    "start_date": "2024-06-01"
  },
  {
    "id": "87654321",
    "name": "Brand Keywords",
    "status": "ENABLED",
    "daily_budget_micros": 30000000,
    "daily_budget": 30.00,
    "currency": "USD",
    "bidding_strategy": "MAXIMIZE_CLICKS",
    "campaign_type": "SEARCH",
    "start_date": "2024-01-15"
  }
]

​
Notes

daily_budget_micros is the budget in micros (millionths of the account currency). The daily_budget field converts this to a human-readable value automatically.
Removed campaigns are excluded by default. Pass status: REMOVED to include them.