Sign in

Get Google Ads launch readiness

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

Returns what Base44 will do on launch, so you can check a launch will succeed before spending anything.

Read this first. It tells you the currency the account will be billed in, whether a card is on file, the business details that will go on the Google Ads account, and the landing page Google will be asked to crawl. Send landing_page back verbatim on Launch campaign rather than deriving the URL yourself: Base44 prefers a custom domain only once it actually routes, and a URL Google cannot fetch gets the campaign rejected after the account already exists.

Nothing is created or charged by this call.

landing_page_ready is best-effort. If Base44 cannot check the app's published address it comes back false with an empty landing_page, which is indistinguishable from an app that genuinely has no crawlable page.

<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/launch-readiness

Path parameters

app_idstring required

ID of the app to advertise.

ID of the app to advertise.

Response

What a launch would do, and whether it can succeed.

has_payment_methodboolean required

Whether the workspace has a card on file. Launching without one is rejected with a 402.

stripe_unavailableboolean required

true when Base44 could not reach its payment provider, so has_payment_method is not trustworthy. Launching in this state is rejected rather than allowed through.

currency_codestring required

Currency the campaign will be billed in. On an account that already exists this is the currency it was created with and cannot change. Otherwise Base44 derives it from where the request comes from, not from how the workspace pays.

account_existsboolean required

Whether the app already has a Google Ads account. When false, launching creates one, which cannot be undone.

account_idstring required

ID of that account, empty when there is none yet.

landing_page_readyboolean required

Whether Base44 resolved a page Google can actually crawl. Launching without one gets the campaign rejected by Google after the account already exists.

landing_pagestring required

The exact URL to send as the campaign's landing_page: a live custom domain if the app has one, otherwise its published address. Empty when neither resolves. Send this rather than building the URL yourself.

Example response

{
  "has_payment_method": true,
  "currency_code": "EUR",
  "account_id": "68b1c0d4e7b91d003c45a1f0",
  "landing_page_ready": true,
  "landing_page": "https://example.com",
  "business_info": {
    "name": "Nordwind Furniture",
    "category": "Furniture store",
    "description": "Handmade oak furniture, delivered across Germany.",
    "phone": "+493012345678"
  }
}

Changes

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