> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Google Ads conversion actions

> <Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns the conversion goals Base44 knows about on the app's Google Ads account.

These are Google's own goals, created when the app's conversion tracking was set up. They are read only, and match on `category` to tell which goal covers which kind of conversion. [Get conversion stats](/api-reference/get-google-ads-conversion-stats) reports what they have recorded.

`conversion_id` and `conversion_label` are empty until Google publishes the goal's tag, which takes a few minutes after the goal is created.

<Note>This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.</Note>

<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.</Warning>



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json get /api/apps/{app_id}/google-ads/conversion-actions
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - ApiKeyAuth: []
paths:
  /api/apps/{app_id}/google-ads/conversion-actions:
    get:
      summary: List Google Ads conversion actions
      description: >-
        <Info>This API is in beta. Endpoints, fields, and behavior may still
        change, so avoid depending on it in production.</Info>


        Returns the conversion goals Base44 knows about on the app's Google Ads
        account.


        These are Google's own goals, created when the app's conversion tracking
        was set up. They are read only, and match on `category` to tell which
        goal covers which kind of conversion. [Get conversion
        stats](/api-reference/get-google-ads-conversion-stats) reports what they
        have recorded.


        `conversion_id` and `conversion_label` are empty until Google publishes
        the goal's tag, which takes a few minutes after the goal is created.


        <Note>This endpoint accepts a personal API key. Workspace API keys are
        not authorized for it and are rejected with a 403.</Note>


        <Warning>The response includes fields beyond the ones documented here.
        Don't rely on undocumented response fields, as they can change at any
        time.</Warning>
      operationId: >-
        list_conversion_actions_api_apps__app_id__google_ads_conversion_actions_get
      parameters:
        - name: app_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              ID of the app whose Google Ads conversion tracking you want to
              manage.
            title: App Id
          description: >-
            ID of the app whose Google Ads conversion tracking you want to
            manage.
          example: 6820f3a4e7b91d003c45a1f2
      responses:
        '200':
          description: The account's conversion goals.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ConversionActionResource'
                title: ConversionActions
        '401':
          description: Missing or invalid credentials.
        '403':
          description: >-
            You don't have access to this app, the app does not exist, or you
            used a workspace API key. A missing app and an app you cannot reach
            are deliberately the same answer.
        '404':
          description: The app has no connected Google Ads account.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ConversionActionResource:
      properties:
        id:
          type: string
          title: Id
          description: Base44's ID for the conversion action.
          example: 68b1c0d4e7b91d003c45a1f6
        google_action_id:
          type: string
          title: Google Action Id
          description: >-
            Google Ads' own ID for the goal, as Google Ads reports it. Not the
            same as `id`.
          example: '7654321'
        action_name:
          type: string
          title: Action Name
          description: Name of the goal in Google Ads.
          example: Purchase
        category:
          type: string
          title: Category
          description: >-
            Google Ads conversion category, for example `PURCHASE`,
            `ADD_TO_CART`, `SUBMIT_LEAD_FORM`, or `SIGN_UP`.
          example: PURCHASE
        action_type:
          type: string
          title: Action Type
          description: >-
            Google Ads conversion type. `WEBPAGE` for the goals Base44 creates.
            Empty on goals created before Base44 recorded the type.
          example: WEBPAGE
        conversion_id:
          type: string
          title: Conversion Id
          description: >-
            The gtag conversion ID for the goal. Empty until Google publishes
            the tag.
          example: AW-123456789
        conversion_label:
          type: string
          title: Conversion Label
          description: >-
            The gtag conversion label for the goal. Empty until Google publishes
            the tag.
          example: AbCdEfGhIj
      type: object
      required:
        - id
        - google_action_id
        - action_name
        - category
        - action_type
        - conversion_id
        - conversion_label
      title: ConversionActionResource
      description: One conversion goal on the Google Ads account.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api_key
      description: Personal API key.

````