Get Google Ads campaign

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

import requests

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

headers = {"api_key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

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

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/campaigns/{campaign_id}', 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/{campaign_id}",
  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/{campaign_id}"

	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/{campaign_id}")

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,
  "landing_page": "https://example.com/spring",
  "geo_targets": [
    "1003854"
  ],
  "phone_number": "+493012345678",
  "review_status": "REVIEWED",
  "serving_status": "SERVING",
  "primary_status": "ELIGIBLE",
  "primary_status_reasons": [
    "CAMPAIGN_BUDGET_LIMITED"
  ],
  "created_date": "2026-08-25T11:20:00Z",
  "updated_date": "2026-08-25T14:05:00Z",
  "learning_ends_at": "2026-09-08T11:20:00Z"
}

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

Campaigns

Get Google Ads campaign

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

Returns one campaign, with the status fields Google reports for it.

Use this for a single campaign’s current state. It reads the same cache as List campaigns and additionally folds in a live check of whether Google has disapproved the campaign’s assets, so a rejected Performance Max campaign shows up here.

A campaign’s name, budget, and targeting come from Base44’s own record, which is refreshed in the background, so a change made directly in the Google Ads UI can take a few minutes to appear here.

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

{campaign_id}

Get Google Ads campaign

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

import requests

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

headers = {"api_key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

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

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/campaigns/{campaign_id}', 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/{campaign_id}",
  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/{campaign_id}"

	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/{campaign_id}")

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,
  "landing_page": "https://example.com/spring",
  "geo_targets": [
    "1003854"
  ],
  "phone_number": "+493012345678",
  "review_status": "REVIEWED",
  "serving_status": "SERVING",
  "primary_status": "ELIGIBLE",
  "primary_status_reasons": [
    "CAMPAIGN_BUDGET_LIMITED"
  ],
  "created_date": "2026-08-25T11:20:00Z",
  "updated_date": "2026-08-25T14:05:00Z",
  "learning_ends_at": "2026-09-08T11:20:00Z"
}

{
  "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.

campaign_id

string

required

Base44's ID for the campaign, as returned in id by List campaigns. This is not the Google Ads campaign ID, which is reported separately as google_campaign_id.

Response

The campaign.

The campaign fields this API commits to.

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. Empty while a just-created campaign is still being pushed to Google.

Example:

"21098765432"

campaign_name

string

required

Name shown for the campaign.

Example:

"Spring sale in Berlin"

campaign_type

enum<string>

required

Campaign type. Base44 creates SMART and PERFORMANCE_MAX; the other values appear only on campaigns created outside Base44 and synced in.

Available options:

SMART,

PERFORMANCE_MAX,

SEARCH,

DISPLAY,

SHOPPING,

VIDEO,

DEMAND_GEN,

LOCAL,

UNKNOWN

Example:

"SMART"

status

enum<string>

required

Serving state in Base44's cache. REMOVED is a deleted campaign, which Google keeps for reporting.

Available options:

ENABLED,

PAUSED,

REMOVED,

UNKNOWN

Example:

"ENABLED"

daily_budget_micros

integer

required

Daily budget in micros of the account currency: 1,000,000 micros is one unit, so 15000000 is 15.00.

Example:

15000000

landing_page

string

required

URL the ads send clicks to.

Example:

"https://example.com/spring"

geo_targets

string[]

required

Google Ads geo target constant IDs the campaign targets.

Example:

["1003854"]

phone_number

string

required

Call-extension phone number, empty when the campaign has none.

Example:

"+493012345678"

review_status

string

required

Google's policy review status, passed through as Google reports it (REVIEWED, UNDER_REVIEW, …). Empty until the first sync after creation.

Example:

"REVIEWED"

serving_status

string

required

Google's serving status, passed through as Google reports it. Can still report review gating after policy review clears, so read it alongside review_status.

Example:

"SERVING"

primary_status

string

required

Google's summary of whether the campaign is serving well, passed through as Google reports it (ELIGIBLE, LIMITED, NOT_SERVING, …).

Example:

"ELIGIBLE"

primary_status_reasons

string[]

required

Google's reasons behind primary_status, e.g. why a campaign is limited. Empty when there is nothing to explain.

Example:

["CAMPAIGN_BUDGET_LIMITED"]

created_date

string<date-time>

required

When the campaign was created in Base44.

Example:

"2026-08-25T11:20:00Z"

updated_date

string<date-time>

required

When Base44 last changed its record of the campaign.

Example:

"2026-08-25T14:05:00Z"

learning_ends_at

string<date-time> | null

When Smart Bidding's learning period is expected to end, about 14 days after creation. null on a campaign that has not started learning.

Example:

"2026-09-08T11:20:00Z"

⌘I

App Management API (Beta)

Entities API (Beta)

Virality API (Beta)

Analytics API (Beta)

Google Ads API (Beta)

Monitoring API

Audit Logs API

Get Google Ads campaign

Authorizations

Path Parameters

Response