Sign in

Get Google Ads account

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

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.

<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>

get/api/apps/{app_id}/google-ads/accounts

Path parameters

app_idstring required

ID of the app whose Google Ads campaigns to manage.

ID of the app whose Google Ads campaigns to manage.

Response

Successful Response

idstring required

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

account_namestring required

Name of the Google Ads account.

google_customer_idstring required

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

statusstring required

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

currency_codestring required

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

timezonestring required

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

budget_activeboolean required

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

billing_cadencestring required

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

charge_trigger_modestring required

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

monthly_spend_cap_microsinteger required

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

auto_renewboolean required

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

budget_window_endstring date-time nullable

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

terms_accepted_atstring date-time nullable

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

business_profile_location_idstring required

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

created_datestring date-time required

When the account was created in Base44.

updated_datestring date-time required

When Base44 last changed its record of the account.

Example response

{
  "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,
  "budget_window_end": "2026-09-30T23:59:59Z",
  "terms_accepted_at": "2026-08-25T11:20:00Z",
  "business_profile_location_id": "locations/12345",
  "created_date": "2026-08-25T11:20:00Z",
  "updated_date": "2026-08-25T14:05:00Z"
}

Changes

Changed in 2 of the 11 revisions of this API.2