agentbit-app Google Ads - Account API

openapi: 3.2.0
info:
  title: AdWhiz Ads Manager Google Ads - Account API
  description: REST API for managing Google Ads and Meta Ads accounts. All 99 tools from the AdWhiz MCP server are available as standard POST endpoints. Authenticate with your API key (Bearer aw_live_...) from https://www.adwhiz.ai/app/api-keys.
  version: 1.0.0
  contact:
    name: AdWhiz Support
    url: https://www.adwhiz.ai
    email: support@adwhiz.ai
servers:
- url: https://mcp.adwhiz.ai
  description: Production
tags:
- name: Google Ads - Account
  description: Account info and listing
paths:
  /api/v1/tools/get_account_info:
    post:
      operationId: get_account_info
      summary: Get detailed information about a specific Google Ads account
      description: 'Get detailed information about a specific Google Ads account.


        Args:

        customer_id: Google Ads customer ID (no dashes, e.g. ''1234567890'').


        Returns:

        Dict with account details: id, name, currency, timezone, manager status,

        optimization score, and descriptive name.'
      tags:
      - Google Ads - Account
      security:
      - bearerApiKey: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                customer_id:
                  title: Customer Id
                  type: string
              required:
              - customer_id
              title: get_account_infoArguments
              type: object
      responses:
        '200':
          description: Tool executed successfully. Response shape depends on the tool.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Invalid request body
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
        '404':
          description: Unknown tool name
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
        '429':
          description: Monthly usage limit exceeded
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
  /api/v1/tools/list_accounts:
    post:
      operationId: list_accounts
      summary: List all Google Ads accounts accessible to the authenticated user
      description: 'List all Google Ads accounts accessible to the authenticated user.


        Returns a list of accounts with their ID, name, and manager status.

        This uses the CustomerService.ListAccessibleCustomers endpoint which

        returns all accounts the user''s OAuth token can access.


        For MCC (manager) accounts, automatically expands child accounts so

        users can see and select the actual ad accounts they want to work with.

        Each child account includes a ''parent_mcc'' field indicating which MCC

        it belongs to.


        Returns:

        List of dicts with keys: customer_id, name, is_manager,

        and optionally parent_mcc (for child accounts under an MCC).

        Returns the cached list from the user''s profile if the live

        API call fails.'
      tags:
      - Google Ads - Account
      security:
      - bearerApiKey: []
      responses:
        '200':
          description: Tool executed successfully. Response shape depends on the tool.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Invalid request body
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
        '404':
          description: Unknown tool name
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
        '429':
          description: Monthly usage limit exceeded
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
components:
  securitySchemes:
    bearerApiKey:
      type: http
      scheme: bearer
      description: 'API key from your AdWhiz dashboard (https://www.adwhiz.ai/app/api-keys). Format: aw_live_<hex>'