---
title: "Suggest Google Ads campaigns"
method: POST
path: "/api/apps/{app_id}/google-ads/campaigns/ai-suggestions"
---

# Suggest Google Ads campaigns

`POST /api/apps/{app_id}/google-ads/campaigns/ai-suggestions`

## Request

- Base URL: `https://app.base44.com`
- URL: `https://app.base44.com/api/apps/{app_id}/google-ads/campaigns/ai-suggestions`
- Auth: HTTP bearer

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

Turns a plain description of a business into a complete Performance Max campaign you can preview and launch.

The suggestion carries a `payload` you can send to [Create campaign](/api-reference/create-google-ads-campaign). Nothing is saved.

You get one suggestion whatever `suggestion_count` says. Google stopped accepting new Smart campaigns on September 23, 2026, so the two Smart Search approaches this used to return are gone.

The Performance Max suggestion cannot launch as-is. `payload.logo_url` and `payload.images` come back empty because this endpoint does not generate images, and Google requires both. Fill both in before you send that payload, hosted where the `images` field of [Create campaign](/api-reference/create-google-ads-campaign) says Base44 can fetch them.

Check `source` before presenting the copy as generated: `fallback` means the model did not run or returned nothing. `title` and `subtitle` are always English, even when the copy inside `payload` is in the app's language, so translate them yourself if you show them to someone.

This one call runs two language-model requests and debits the shared quota twice.

<Note>This endpoint runs a language model and draws on a shared quota of 20 requests per minute per app, which every Google Ads AI endpoint debits. Enterprise workspaces get a higher quota. A 429 means the quota is spent, not that this endpoint has its own limit.</Note>

<Note>This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.</Note>

## Path parameters

- `app_id` string, required: ID of the app you are planning a Google Ads campaign for.

## Request body

- AICampaignBrief
  - `business_name` string: Name of the business to build campaigns for.
  - `business_description` string: What the business sells, in a sentence or two. This is what the suggestions are built from.
  - `landing_page_url` string: Page the campaigns would send people to.
  - `campaign_goal` string: What the campaigns are for: `traffic`, `leads` or `sales`.
  - `daily_budget_micros` integer: Daily budget each suggestion is sized for, in micros (1,000,000 micros = 1 unit of the account's currency).
  - `suggestion_count` integer: How many suggestions to return. Only one approach exists (Performance Max), so any value returns one.
  - `geo_targets` string[]: Locations the campaigns would target, as Google geo target constant IDs. Sharpens the click estimates.

## Response `200`

Campaigns you can preview and launch.

- GoogleAdsCampaignSuggestions: Suggested campaigns for a business description.
  - `suggestions` GoogleAdsCampaignSuggestion[], required: The suggested campaigns. Always exactly one, however many you asked for.
    - `id` string, required: Stable ID for the suggestion. Always `pmax-leads`.
    - `title` string, required: One-line name for the approach. Always English, even when the copy in `payload` is in another language.
    - `subtitle` string, required: What this approach is best for. Always English, even when the copy in `payload` is in another language.
    - `campaign_type` string, required: Always `PERFORMANCE_MAX`.
    - `estimated_daily_clicks` integer, required: Rough daily clicks this approach could produce at the budget you sent. At least 1.
    - `estimate_source` string, required: Where `estimated_daily_clicks` came from. `planner_anchored` means it is scaled from Google's own forecast for this account. `heuristic` means Google was not consulted, because the app has no connected account yet or the forecast was unavailable, and the number is a rough calculation from the budget alone.
    - `payload` GoogleAdsCampaignSuggestionDraft, required: A ready-to-send body for [Create campaign](/api-reference/create-google-ads-campaign).
      - `campaign_name` string, required: Suggested campaign name, trimmed to 120 characters.
      - `campaign_type` string, required: Always `PERFORMANCE_MAX`.
      - `business_name` string, required: The business name you sent, echoed back.
      - `landing_page` string, required: The `landing_page_url` you sent, echoed back.
      - `daily_budget_micros` integer, required: The `daily_budget_micros` you sent, echoed back.
      - `headlines` string[], required: Generated headlines for the campaign's ads.
      - `descriptions` string[], required: Generated description lines for the campaign's ads.
      - `keyword_themes` string[], required: Up to five generated keyword themes.
      - `settings` object, required: Campaign settings to send on unchanged. Carries `language_code`, the language this suggestion's copy was written in, whenever the model reported one; empty otherwise. Drop it and the campaign is created targeting English while its copy is not.
      - `logo_url` string, required: Always empty. Performance Max campaigns need a logo to launch, so fill this in before you send the draft.
      - `images` string[], required: Always empty. Performance Max campaigns need marketing images to launch, so fill these in before you send the draft, as image objects in the shape [Create campaign](/api-reference/create-google-ads-campaign) documents for `images`. Create rejects a bare URL string.
  - `language` string, nullable: Two-letter code for the language the generated copy came back in, or `null` when the model did not report one.
  - `source` string, required: `ai` when a language model wrote the copy in these suggestions, `fallback` when it did not run or returned nothing.

## Other responses

- `401`: Missing or invalid credentials.
- `403`: You don't have access to this app, the app does not exist, or you used a workspace API key. A missing app and an app you cannot reach are deliberately the same answer. Marketing setup, campaign edits, generation and resuming also return `app_marketing_not_allowed` when the app's owning workspace has the FERPA designation. Historical reads, pausing, deletion and financial settlement remain available.
- `422`: Validation Error
- `429`: The shared AI quota for this app is spent. This endpoint debits it twice. Retry in a minute.

## Changes

> 58 revisions in range; 1 not diffed.

- **2026-10-12** `5e139db2e643`: 1 info
  - the endpoint scheme security `PersonalAccessTokenAuth` was added to the API
- **2026-09-18** `f70e515893d2`: 1 info
  - added the new optional request property `geo_targets`

[Operation history](https://skmtc.dev/adexad/apis/base44-app-management-api/changes/api/apps/:app_id/google-ads/campaigns/ai-suggestions/post.md)

---

[API](https://skmtc.dev/adexad/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/adexad/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adexad/apis/base44-app-management-api/revisions/fa29e915c226?raw)