IDidealspot

Get Google Ads launch readiness

Changed on

<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, the landing page Google will be asked to crawl, and the daily budget range launch accepts in that currency. 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

Request

  • Base URL
    https://app.base44.com
  • URL
    https://app.base44.com/api/apps/{app_id}/google-ads/launch-readiness
  • Auth
    HTTP bearer

Path parameters

app_idstring required

ID of the app to advertise.

Query parameters

campaign_typestring

Campaign type to quote the daily budget range for, as sent on launch: PERFORMANCE_MAX (the launch default) or SMART.

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.

billing_cadencestring required

How often the campaign will be charged once launched: 3d, 1w, 2w, or 1m. Answered before the account exists so the billing terms shown at launch match how the account is actually charged.

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.

budget_campaign_typestring required

Campaign type the budget range below is quoted for: the campaign_type query parameter, upper-cased.

min_daily_budget_microsinteger required

Lowest daily budget launch accepts, in micros of currency_code (1,000,000 micros = 1 unit). A lower budget is rejected with a 400.

max_daily_budget_microsinteger required

Highest daily budget launch accepts, in micros of currency_code. A higher budget is rejected with a 400.

Example response

{
  "has_payment_method": true,
  "currency_code": "EUR",
  "account_id": "68b1c0d4e7b91d003c45a1f0",
  "billing_cadence": "1w",
  "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"
  },
  "budget_campaign_type": "PERFORMANCE_MAX",
  "min_daily_budget_micros": 8000000,
  "max_daily_budget_micros": 85000000
}

Changes

  • 76f6f172b718Revision changes
    • info

      added the new optional query request parameter campaign_type

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • 80287813ab84Revision changes
    • info

      the endpoint scheme security PersonalAccessTokenAuth was added to the API