Get Google Ads account

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/accounts \
  --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/accounts', 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/accounts",
  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/accounts"

	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/accounts")

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": "68b1c0d4e7b91d003c45a1f8",
  "account_name": "Nordwind Furniture",
  "google_customer_id": "1234567890",
  "status": "ACTIVE",
  "currency_code": "EUR",
  "timezone": "Europe/Berlin",
  "budget_active": true,
  "billing_cadence": "1w",
  "charge_trigger_mode": "cadence",
  "monthly_spend_cap_micros": 500000000,
  "auto_renew": true,
  "business_profile_location_id": "locations/12345",
  "created_date": "2026-08-25T11:20:00Z",
  "updated_date": "2026-08-25T14:05:00Z",
  "budget_window_end": "2026-09-30T23:59:59Z",
  "terms_accepted_at": "2026-08-25T11:20:00Z"
}

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

Accounts

Get Google Ads account

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 account: its status, currency, billing cadence, spend cap and the Google Business Profile linked to it.

An app has at most one Google Ads account. status is the field to read before anything else, because only an ACTIVE account can create or resume campaigns. budget_active is the second: a campaign cannot serve without a live Google Ads budget behind it.

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

accounts

Get Google Ads account

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/accounts \
  --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/accounts', 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/accounts",
  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/accounts"

	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/accounts")

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": "68b1c0d4e7b91d003c45a1f8",
  "account_name": "Nordwind Furniture",
  "google_customer_id": "1234567890",
  "status": "ACTIVE",
  "currency_code": "EUR",
  "timezone": "Europe/Berlin",
  "budget_active": true,
  "billing_cadence": "1w",
  "charge_trigger_mode": "cadence",
  "monthly_spend_cap_micros": 500000000,
  "auto_renew": true,
  "business_profile_location_id": "locations/12345",
  "created_date": "2026-08-25T11:20:00Z",
  "updated_date": "2026-08-25T14:05:00Z",
  "budget_window_end": "2026-09-30T23:59:59Z",
  "terms_accepted_at": "2026-08-25T11: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.

Response

The app's Google Ads account.

The account fields this API commits to.

A subset. GoogleAdsAccount also carries Base44's billing-retry counters, risk-screening and block-source IDs, notification fingerprints, Google billing-setup IDs and setup error strings, none of which are a caller's contract.

string

required

Base44's ID for the account. Pass it as account_id on the other account endpoints.

Example:

"68b1c0d4e7b91d003c45a1f8"

account_name

string

required

Name of the Google Ads account.

Example:

"Nordwind Furniture"

google_customer_id

string

required

The account's customer ID in Google Ads. Empty until Google has provisioned it.

Example:

"1234567890"

status

string

required

ACTIVE, BLOCKED, SUSPENDED, BILLING_HOLD, CANCELED, PENDING_VERIFICATION, PENDING_BILLING_SETUP, or PENDING_CLOSE. Only an ACTIVE account can create or resume campaigns.

Example:

"ACTIVE"

currency_code

string

required

Currency the account bills in, as an ISO 4217 code.

Example:

"EUR"

timezone

string

required

Time zone the account reports in, as an IANA name.

Example:

"Europe/Berlin"

budget_active

boolean

required

true when the account has a live Google Ads budget, which campaigns need in order to serve.

Example:

true

billing_cadence

string

required

How often the account is charged: 1w, 2w, or 1m. Only drives charging when charge_trigger_mode is cadence.

Example:

"1w"

charge_trigger_mode

string

required

What triggers a charge on this account. cadence charges on the billing_cadence schedule. threshold is a legacy mode that charges when spend crosses a ladder of thresholds and ignores billing_cadence entirely.

Example:

"cadence"

monthly_spend_cap_micros

integer

required

Monthly spend cap in micros of the account currency, so 500000000 is 500.00. 0 when no cap is set.

Example:

500000000

auto_renew

boolean

required

true when the account's budget renews automatically at the end of its window.

Example:

true

business_profile_location_id

string

required

Google Business Profile location linked to the account, as locations/<id>. Empty when none is linked.

Example:

"locations/12345"

created_date

string<date-time>

required

When the account was created in Base44.

Example:

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

updated_date

string<date-time>

required

When Base44 last changed its record of the account.

Example:

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

budget_window_end

string<date-time> | null

When the current budget window ends. null before a budget exists.

Example:

"2026-09-30T23:59:59Z"

terms_accepted_at

string<date-time> | null

When the Google Ads terms were accepted for this account. null until they are.

Example:

"2026-08-25T11: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 account

Authorizations

Path Parameters

Response