List Google Ads campaigns

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/campaigns \
  --header 'api_key: <api-key>'

const options = {method: 'GET', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/campaigns', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/google-ads/campaigns",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/google-ads/campaigns"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api_key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/google-ads/campaigns")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api_key"] = '<api-key>'

response = http.request(request)
puts response.read_body

[
  {
    "id": "68b1c0d4e7b91d003c45a1f2",
    "google_campaign_id": "21098765432",
    "campaign_name": "Spring sale in Berlin",
    "campaign_type": "SMART",
    "status": "ENABLED",
    "daily_budget_micros": 15000000,
    "start_date": "2026-08-25",
    "impressions": 15420,
    "clicks": 612,
    "cost_micros": 248000000,
    "spend": 248,
    "conversions": 31,
    "ctr": 0.0397,
    "review_status": "REVIEWED",
    "serving_status": "SERVING",
    "primary_status": "",
    "primary_status_reasons": [
      "CAMPAIGN_BUDGET_LIMITED"
    ],
    "metrics_pending": true
  }
]

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Campaigns

List Google Ads campaigns

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

Returns the app’s Google Ads campaigns, including paused and deleted ones. Check status to tell them apart.

Each row carries the campaign’s id, name, type, status, daily budget, and its performance metrics. Pass an id to Get campaign for the campaign’s landing page, targeting, and phone number, which the list rows leave out, or to the pause, resume, update, and delete endpoints.

By default Base44 reads the metrics live from Google Ads. Pass include_metrics=false to skip that round trip, which returns the same fields with the metric ones zeroed and metrics_pending set to true. Either way primary_status comes back empty on this endpoint; read one campaign to get it.

The live read returns at most 50 campaigns, ordered by spend, and there is no pagination. An account with more than 50 active campaigns gets an incomplete list with nothing in the response to say so.

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

The response includes fields beyond the ones documented here. Don’t rely on undocumented response fields, as they can change at any time.

GET

api

apps

{app_id}

google-ads

campaigns

List Google Ads campaigns

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/campaigns \
  --header 'api_key: <api-key>'

const options = {method: 'GET', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/campaigns', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/google-ads/campaigns",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/google-ads/campaigns"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api_key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/google-ads/campaigns")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api_key"] = '<api-key>'

response = http.request(request)
puts response.read_body

[
  {
    "id": "68b1c0d4e7b91d003c45a1f2",
    "google_campaign_id": "21098765432",
    "campaign_name": "Spring sale in Berlin",
    "campaign_type": "SMART",
    "status": "ENABLED",
    "daily_budget_micros": 15000000,
    "start_date": "2026-08-25",
    "impressions": 15420,
    "clicks": 612,
    "cost_micros": 248000000,
    "spend": 248,
    "conversions": 31,
    "ctr": 0.0397,
    "review_status": "REVIEWED",
    "serving_status": "SERVING",
    "primary_status": "",
    "primary_status_reasons": [
      "CAMPAIGN_BUDGET_LIMITED"
    ],
    "metrics_pending": true
  }
]

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

api_key

string

header

required

Personal API key.

Path Parameters

app_id

string

required

ID of the app whose Google Ads campaigns to manage.

Query Parameters

include_metrics

boolean

default:true

Whether to include each campaign's performance metrics, which are fetched from Google on the fly. Pass false to return the cached campaign records on their own, which is faster.

Response

The account's campaigns. The shape depends on include_metrics; this is the default, metrics-carrying one.

string

required

Base44's ID for the campaign. Pass this as campaign_id on the other campaign endpoints.

Example:

"68b1c0d4e7b91d003c45a1f2"

google_campaign_id

string

required

The campaign's ID in Google Ads.

Example:

"21098765432"

campaign_name

string

required

Name shown for the campaign.

Example:

"Spring sale in Berlin"

campaign_type

string

required

Campaign type.

Example:

"SMART"

status

string

required

Serving state. REMOVED is a deleted campaign, which stays listed for reporting.

Example:

"ENABLED"

daily_budget_micros

integer

required

Daily budget in micros of the account currency, so 15000000 is 15.00.

Example:

15000000

start_date

string

required

Date the campaign started, or empty when it has not.

Example:

"2026-08-25"

impressions

integer

required

Impressions. 0 when metrics_pending is true.

Example:

15420

clicks

integer

required

Clicks. 0 when metrics_pending is true.

Example:

612

cost_micros

integer

required

Spend in micros of the account currency. 0 when metrics_pending is true.

Example:

248000000

spend

number

required

cost_micros as a decimal amount, for display.

Example:

248

conversions

number

required

Conversions. 0 when metrics_pending is true.

Example:

31

ctr

number

required

Click-through rate. 0 when metrics_pending is true.

Example:

0.0397

review_status

string

required

Google's policy review status. Always empty on a deleted campaign.

Example:

"REVIEWED"

serving_status

string

required

Google's serving status. Always empty on a deleted campaign.

Example:

"SERVING"

primary_status

string

required

Always empty on this endpoint. Read one campaign to get it.

Example:

""

primary_status_reasons

string[]

required

Google's reasons why the campaign is limited or not serving. Always empty on a deleted campaign.

Example:

["CAMPAIGN_BUDGET_LIMITED"]

metrics_pending

boolean | null

Present and true only when you passed include_metrics=false, meaning the metric fields above are zeroed rather than measured.

Example:

true

⌘I

App Management API (Beta)

Entities API (Beta)

Virality API (Beta)

Analytics API (Beta)

Google Ads API (Beta)

Monitoring API

Audit Logs API

List Google Ads campaigns

Authorizations

Path Parameters

Query Parameters

Response