list_conversion_actions

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

🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the upgrade link) - DO NOT attempt to work around the error or use alternative data - DO NOT create campaigns or perform actions without valid tool data - STOP and direct the user to upgrade via the provided link List conversion actions for the connected Google Ads account with full per-action metadata. This tool retrieves READ-ONLY data. Safe to call multiple times. **Returns for each conversion action:** - id, name, resource_name - category (PURCHASE, SUBMIT_LEAD_FORM, SIGNUP, ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, etc.) - status (ENABLED, REMOVED, HIDDEN) - type (WEBPAGE, UPLOAD_CLICKS, GOOGLE_ANALYTICS_4, FIREBASE_*, etc.) - counting_type (ONE_PER_CLICK or MANY_PER_CLICK) - primary_for_goal (true if this action is primary for its category goal) - include_in_conversions_metric (true if it counts in Smart Bidding "Conversions") - click_through_lookback_window_days, view_through_lookback_window_days - value_settings: default_value, default_currency_code, always_use_default_value - attribution_model (GOOGLE_ADS_LAST_CLICK, DATA_DRIVEN, etc.) **Parameters:** - customer_id: Optional Google Ads customer ID (uses primary if omitted) - status_filter: 'ENABLED' (default — matches Google Ads UI active list), 'all' (include HIDDEN), or 'primary' (only primary_for_goal=true) - include_removed: false by default (matches Google Ads UI). Set true to include status=REMOVED for full audit. **Execution time:** 1-3 seconds (single GAQL query, cached 1 hour in Redis) **Use this tool when:** - User asks for conversion setup, conversion action list, or conversion tracking audit beyond a health-score summary - User wants per-action category, counting mode, or value settings to reason about ROAS / TARGET_ROAS bidding - User wants to see secondary or non-primary actions that audit_conversion_tracking truncates - Before any per-conversion-action analysis (downstream tools may need the action IDs) **Tip:** For accounts with many actions (100+), `status_filter='primary'` returns just the goal-primary actions used by Smart Bidding — usually the most relevant subset.

{
  "arguments": {
    "customer_id": "string",
    "status_filter": "ENABLED",
    "include_removed": false
  }
}

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

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

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