Retry Google Ads billing setup

Changed on

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

Retries the Google Ads billing setup for an account whose first attempt failed.

Use this when the account is stuck in PENDING_BILLING_SETUP. It returns the account, so read status on the response to see whether the retry moved it on. A retry that fails again leaves the account where it was rather than erroring.

This needs a payment method on the workspace, and the workspace must not be on a billing hold.

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

post/api/apps/{app_id}/google-ads/accounts/{account_id}/retry-billing-setup

Request

  • Base URL: https://app.base44.com
  • URL: https://app.base44.com/api/apps/{app_id}/google-ads/accounts/{account_id}/retry-billing-setup
  • Auth: HTTP bearer

Path parameters

app_idstring required

ID of the app to advertise.

account_idstring required

ID of the Google Ads account, as returned in id by Get Google Ads account. An account that belongs to a different app returns a 403.

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: 3d, 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.

customer_gradeinteger

How far the workspace has earned higher limits by paying on time. 0 until 3 invoices in a row are paid with no decline, then 1, rising by one per further clean invoice. It never goes down; it reads 0 only while an account in the workspace is on hold or blocked.

active_campaign_limitinteger

How many of the account's campaigns can be enabled at once. 2, plus one per customer_grade, up to 5.

total_campaign_limitinteger

How many campaigns the account can hold in total, enabled or paused. Archived campaigns don't count.

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",
  "customer_grade": 1,
  "active_campaign_limit": 3,
  "total_campaign_limit": 5,
  "created_date": "2026-08-25T11:20:00Z",
  "updated_date": "2026-08-25T14:05:00Z"
}

Changes